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PREFACE 


This manual describes the PDP-11 MACRO-11 Assembler (MACH) and 
Assembly Language and discusses briefly how to program the PDP-11 
computer. It is recommended that the reader have copies of the PDP-11 
Processor Handbook and, optionally, the PDP-11 Peripherals and 
Interfacing Handbook. References are made to these documents 

throughout this manual (although this document is complete, the 
additional material provides further details). The user is also 
advised to obtain a PDP-11 pocket Instruction List card for easy 
reference. (These items can be obtained from the Digital Software 
Distribution Center.) 

This MACRO-11 Assembler operates under the XVM/DOS (Disk Operating 
System) in conjunction with PIREX, a multiprogramming executive 
running on a PDP-11 in the XVM UNICHANNEL configuration system. 

Some notable features of MACH are: 

1. Device and filename specifications for input 

2. Error listing on command output device 

3. Alphabetized, formatted symbol table listing 

4. Conditional assembly directives 

5. User defined macros 

6. Extensive listing control 


Associated Documents: 


PDP-11/05/10/35/40 Processor Handbook 
PDP-11 Peripherals and Interfacing Handbook 
XVM UNICHANNEL Software Manual 
XVM/DOS Users Manual 

EDIT/EDITVP/EDITVT XVM Utility Manual 
PIP XVM Utility Manual 

The MACH assembler, a subset of the standard MACRO-11 assembler for 
the PDP-11, is specifically written for the VXM system. Programs 
written for the MACRO-11 assembler will not necessarily assemble 
correctly with MACll, and programs written for MAC11 will not 
necessarily assemble correctly with MACRO-11. 

The MACll assembler generates only absolute binary output. 


IX 




CHAPTER 1 


FUNDAMENTALS OF PROGRAMMING THE PDP-11 


This Chapter presents some fundamental software concepts essential to 
efficient assembly language programming- of the PDP-11 computer. A 
description of the hardware components of the PDP-11 family can be 
found in the two DEC paperback handbooks: 

PDP-11 Processor Handbook 

PDP-11 Peripherals and Interfacing Handbook 

No attempt is made in this document to' describe the PDP-11 hardware or 
the function of the various PDP-11 instructions. However, it is 
recommended that the reader become familiar with this material before 
proceeding . 

The new PDP-11 programmer is advised to read this Chapter before 
reading further in this manual. The concepts in this Chapter will 
create a conceptual matrix within which explanations of the language 
fit. Since the techniques described herein work best with the PDP-11 
and are used in PDP-11 system programs, they should be considered from 
the very start of your PDP-11 programming experience. 


1.1 MODULAR PROGRAMMING 


The PDP-11 family of computers lend themselves most easily to a 
modular system of programming. In such a system the programmer must 
envision the entire program and break it down into constituent 
subroutines. Modular development forces an awareness of the final 
system. Ideally, this should cause all components of the system to be 
considered from the very beginning of the development effort rather 
than patched into a partially-developed system. This provides for the 
best use of the PDP-11 hardware (as discussed later in this Chapter) , 
and results in programs which are more easily modified than those 
coded with straight-line coding techniques. 

To this end, flowcharting of the entire system is best performed prior 
to coding rather than during or after the coding effort. The 
programmer is then able to work on small portions of the program at a 
time. Subroutines of approximately one or two pages are considered 
desirable . 


Modular programming practices maximize the usefulness of an 
installation's resources. Programmed modules can be used in other 
programs or systems having similar or identical functions without the 
expense of redundant development. Also software modules developed as 
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functional entities are more likely to be free of .serious logical 
errors as a result of the original programming effort. The use of 
such modules will simplify the development of later systems by 
incorporating proven pieces. 

Modular development provides for ease of use and modification rather 
than simplifying the original development. While care must be taken 
in the beginning to ensure correct modular system development, the 
benefits of standardization to the generation of maintenance 
programmers which deal with a given assembly are many. (See also the 
notes under Commenting Assembly Language Programs.) 

PDP-11 assembly language programming best follows a tree-like 
structure with the top of the tree being the final results and the 
base being the smallest component function. (The Assembler itself is 
a tree structure and is briefly described in Figure 1-1.) 


1.1.1 Commenting PDP-11 Assembly Language Programs 

When programming in a modular fashion, it is desirable to heavily 
comment the beginning of each subroutine, telling what that routine 
does: its inputs, outputs, and register usage. 

Since subroutines are short and encompass only one operation it is not 
necessary to tell how the subroutine functions, but only what it does. 
An explanation of how a subroutine functions should be documented only 
when the procedure is not obvious to the reader. This enables any 
later inspection of an unclear subroutine to disclose the maximum 
amount of useful information to the reader. 


1.1.2 Localized Register Usage 

A useful technique in writing subroutines is to save all registers 
upon entering a subroutine and restore them prior to leaving the 
subroutine. This allows the programmer unrestricted use of the PDP-11 
registers, including the program stack, during a subroutine. 

Use of registers avoids 2- and 3-word addressing instructions. The 
code in Figure 1-2 compares the use of registers with symbolic 
addressing. Register use is faster and requires less storage space 
thatn symbolic addressing. 
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Figure 1-1 

Problem-Oriented Tree-Structure 
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1.1.3 Conditional Assemblies 

Conditional assemblies are valuable in macro definitions. The 
expansion of a macro can be altered during assembly as a result of 
specific arguments passed and their use in conditionals. For example, 
a macro can be written to handle a given data item differently, 
depending upon the value of the item. Only a single algorithm need be 
expanded with each macro call. (Conditionals are described in detail 
in Section 5.7.) 

Conditional assemblies can also be used to generate different versions 
of a program from a single source. This is usually done as a result 
of one or more symbols being either defined or undefined. Conditional 
assemblies are preferred to the creation of a multiplicity of sources. 
This principle is followed in the creation of PDP-11 system programs 
for the following reasons: 

1. Maintenance of a single source program is easier, and 
guarantees that a change in one version of the program, which 
may affect other versions, is reflected automatically in all 
possible versions. 

2. Distribution of a single source program allows a customer or 
individual user to tailor a system to his configuration and 
needs and continue to update the system as the hardware 
environment or programming requirements change. 

3. As in the case of maintenance, the debugging and checkout 
phase of a single program (even one containing many separate 
modules) is easier than testing several distinct versions of 
the same basic program. 


1.2 REENTRANT CODE 

Both the interrupt handling hardware and the subroutine call 
instructions (JSR, RTS, EMT, and TRAP) facilitate writing reentrant 
code for the PDP-11. Reentrant code allows a single copy of a given 
subroutine or program to be shared by more than one process or task. 
This reduces the amount of core needed for multi-task applications 
such as the concurrent servicing of peripheral devices. 

On the PDP-11, reentrant code depends upon the stack for storage of 
temporary data values and the current processing status. Presence of 
information in the stack is not affected by the changing of 
operational control from one task to another. Control is always able 
to return to complete an operation which was begun earlier but not 
completed . 


1.3 PREFERRED ADDRESSING MODES 

Addressing modes are described in detail in Chapter 4. Basically, the 
PDP-11 programmer has eight types of register addressing and four 
types of addressing through the PC register. Those operations 
involving general register addressing take one word of core storage, 
while symbolic addressing can use up to three words. For example: 

MOV A , B ; THREE WORDS OF STORAGE 

MOV R0,R1 ; ONE WORD OF STORAGE 
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The user is advised to perform as many operations as possible with 
register addressing modes, and to use the remaining addressing modes 
to preset the registers for an operation. This technique saves space 
and time over the course of a program. 


1.4 PARAMETER ASSIGNMENTS 

Parameter assignments should be used to enable a program to be easily 
followed through the use of a symbolic cross reference (CREF listing) . 
For example: 

SYM=4 2 


MOV #SYM , RO 

Another standard PDP-11 convention is to name the general registers as 
follows : 

RO = %0 

R1 = %1 

R2 = %2 

R3 = % 3 

R4 = %4 

R5 = % 5 

SP = %6 (processor stack pointer) 

PC = %7 (program counter) 


1.5 SPACE VS. TIMING TRADEOFFS 

On the PDP-11 as on all computers, some techniques lead to savings in 
storage space and others lead to decreased execution time. Only the 
individual user can determine which is the best combination of the two 
for his application. It is the purpose of this section to describe 
several means of conserving core storage and/or saving time. 


1.5.1 Trap Handler 

The use of the trap handler and a dispatch table conserves core 
requirements in subroutine calling, but can lead to a decrease in 
execution speed due to indirect transfer of control. To illustrate, a 
subroutine call can be made in either of the following ways: 

1. A JSR instruction which generally requires two PDP-11 words: 

JSR R5 , SUBA 
but is direct and fast. 

2. A TRAP instruction which requires one in-line PDP-11 word: 

TRAP N 

but is indirect and slower. The TRAP handler must use N to 
index through a dispatch table of subroutine addresses and 
then JMP to the Nth subroutine in the table. 
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1.5.2 Register Increment 
The operation: 

CMPB (RO) +, (RO) + 
is preferable to: 

TST (R0)+ 

to increment RO by 2, especially where the initial contents of RO may 
be odd . 


1.6 CONDITIONAL BRANCH INSTRUCTIONS 


When using the PDP-11 conditional branch instructions, it is 
imperative that the correct choice be made between the signed and the 
unsigned branches. 


SIGNED 

UNSIGNED 

BGE 

BHIS 

(BCC) 

BLT 

BLO 


BGT 

BHI 


BLE 

BLOS 

( BCS ) 


A common error is to use a signed branch (e.g., BGT) when comparing 
two memory addresses. A problem occurs when the two addresses have 
opposite signs; that is, one address goes across the 16K (100000(8)) 
boundary. This type of coding error usually appears as a result of 
relinking at different addresses and/or a change in the size of the 
program . 
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CHAPTER 2 


SOURCE PROGRAM FORMAT 


A source program is composed of a sequence of source lines, where each 
line contains a single assembly language statement. Each line is 
terminated by either a line feed or a vertical-tab character (which 
increments the line count by 1) or a form-feed character (which 
increments both the line count and page count by 1) . 

Since the MACH Interface automatically appends a line feed at the end 
of every logical input line, the user need not concern himself with 
the statement terminator. However, a carriage return character not 
followed by a statement terminator generates an error flag. A legal 
statement terminator not immediately preceded by a carriage return 
causes the Assembler to insert a carriage return character for listing 
purposes . 

An assembly language line can contain up to 80(10) characters 
(exclusive of the statement terminator). Beyond this limit, excess 
characters are ignored and generate an error flag. 


2.1 STATEMENT FORMAT 

A statement can contain up to four fields which are identified by 
order of appearance and by specified terminating characters. The 
general format of a MACH assembly language statement is: 

label: operator operand jcomments 

The label and comment fields are optional. The operator and operand 
fields are interdependent; either may be omitted depending upon the 
contents of the other . 

The Assembler interprets and processes these statements one by one, 
generating one or more binary instructions or data words or performing 
an assembly process. A statement must contain one of these fields and 
may contain all four types. Blank lines are legal. 

Some statements have one operand, for example: 

CLR R0 

while others have two, 

MOV #ERR,R2 

An assembly language statement must be complete on one source line. 
No continuation lines are allowed. 
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MASK=- < L 
RE GIST l 

'i 

BIT 

REG 

1! MASK VALUE 
EEGERX 

?~ 

EE GERE l 

JMP 

EE EE OR 

9 N (!) v E E E 0 E 

EEGERX J 

MOM 

BIG 

BR 

♦DEFFLG ! EEGFLG MODE 
#MASK ? VALUE 
ABSEKX 

5 SET MODE * 


2.1.1 Label Field 

A label is a user-defined symbol which is assigned the value of the 
current location counter and entered into the user-defined symbol 
table. The value of the label is absolute. 

A label is a symbolic means of referring to a specific location within 
a program. If present, a label always occurs first in a statement and 
must be terminated by a colon. For example, if the current location 
is absolute 100(8), the statement: 

ABCD : MOV A , B 

assigns the value 100(8) to the label ABCD. Subsequent reference to 
ABCD references location 100(8). 

More than one label may appear within a single label field; each 
label within the field has the same value. For example, if the 
current location counter is 100(8), the multiple labels in the 
statement : 


ABC: $DD : A7.7: MOV A , B 

cause each of the three labels ABC, $DD , and A7.7 to be equated to the 
value 100 (8) . 

The first six characters of a label are significant. An error code is 
generated if more than one label share the same first six characters. 

A symbol used as a label may not be redefined within the user program. 
An attempt to redefine a label results in an error flag in the 
assembly listing. 
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2.1.2 Operator Field 


An operator field follows the label field in a statement, and may 
contain a macro call, an instruction mnemonic, or an assembler 
directive. The operator may be preceded by none, one or multiple 
labels and may be followed by one or more operands and/or a comment. 
Leading and trailing spaces and tabs are ignored. 


When the operator is a macro call, the Assembler inserts the 
appropriate code to expand the macro. When the operator is an 
instruction mnemonic, it specifies the instruction to be generated and 
the action to be performed on any operand (s) which follow. When the 
operator is an Assembler directive, it specifies a certain function or 
action to be performed during assembly. 

An operator is legally terminated by a space, tab, or any 
non-alphanumer ic character (symbol component). 


Consider the following examples: 

MOV A , B (space terminates the operator MOV) 
MOV@A , B (@ terminates the operator MOV) 


When the statement line does not contain an operand or comment 
operator is terminated by a carriage return followed by a line 
vertical tab or form feed character. 


the 
feed , 


A blank operator field is interpreted as a .WORD assembler directive 
( see Section 5.3.2) . 


2.1.3 Operand Field 

An operand is that part of a statement which is manipulated by the 
operator. Operands may be expressions, numbers, or symbolic or macro 
arguments (within the context of the operation) . When multiple 
operands appear within a statement, each is separated from the next by 
one of the following characters: comma, tab, space or paired angle 
brackets around one or more operands (see Section 3.1.1). An operand 
may be preceded by an operator, label or other operand and followed by 
a comment. 

The operand field is terminated by a semicolon when followed by a 
comment, or by a statement terminator when the operand completes the 
statement. For example: 

LABEL: MOV A , B ; COMMENT 

The space between MOV and A terminates the operator field and begins 
the operand field; a comma separates the operands A and B; a 
semicolon terminates the operand field and begins the comment field. 


2.1.4 Comment Field 


The comment field is optional and may contain any ASCII 
except null, rubout, carriage return, line feed, vertical 
feed. All other characters, even special characters with 
usage, are ignored by the Assembler when appearing in 
f ield . 


characters 
tab or form 
a defined 
the comment 
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The comment field may be preceded by one, any, none or all of the 
other three field types. Comments must begin with the semicolon 
character and end with a statement terminator. 

Comments do not affect assembly processing or program execution, but 
are useful in source listings for later analysis, debugging, or 
documentation purposes. 


2.2 FORMAT CONTROL 

Horizontal or line formatting of the source program is controlled by 
the space and tab characters. These characters have no effect on the 
assembly process unless they are embedded within a symbol, number, or 
ASCII text; or unless they are used as the operator field terminator. 
Thus, these characters can be used to provide an orderly source 
program. A statement can be written; 

LABEL : MOV ( SP) +, TAG, -POP VALUE OFF STACK 

or, using formatting characters, it can be written: 

LABEL; MOV (SP)+,TAG ; POP VALUE OFF STACK 

which is easier to read in the context of a source program listing. 

The XVM Edit program can be used to achieve the desired format. 

Vertical formatting, i.e., page size, is controlled by the form feed 
character. A page of n lines is created by inserting a form feed 
(type the CTRL/FORM keys on the keyboard) after the nth line. See 
Section 5.1.5 for other methods of vertical formatting. 


1 
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SYMBOLS AND EXPRESSIONS 


This Chapter describes the various components of 
expressions: the Assembler character set, symbol 

numbers, operators, terms and expressions. 


legal MACH 
construction , 


3.1 CHARACTER SET 

The following characters are legal in MACH source programs: 

1. The letters A through Z. Both upper and lower case letters 
are acceptable although, upon input, lower case letters are 
converted to upper case letters. Lower case letters can only 
be output by sending their ASCII values to the output device. 
This conversion is not true for .ASCII, .ASCIZ, 1 (single 
quote) or " (double quote) statements if . ENABL LC is in 
effect . 

2. The digits 0 through 9. 

3. The characters . (period or dot) and $ (dollar sign), 

The special characters are as follows: 


Character Designation 

carriage return 
line feed \ 

form feed / 

vertical tab / 


: colon 

= equal sign 

% percent sign 

tab 
space 

# number sign 


Function 

formatting character 

source statement terminators 

label terminator 
direct assignment indicator 
register term indicator 
item or field terminator 
item or field terminator 
immediate expression indicator 
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Character Designation 

0 at sign 

( left parenthesis 

) right parenthesis 

1 comma 

; semi-colon 

< left angle bracket 

> right angle bracket 

+ plus sign 

minus sign 

* asterisk 

/ slash 

& ampersand 

! exclamation 

" double quote 

' single quote 

* up arrow 

\ backslash 


EXPRESSIONS 

Function 

deferred addressing indicator 

initial register indicator 

terminal register indicator 

operand field separator 

comment field indicator 

initial argument or expression 
ind icator 

terminal argument or expression 
indicator 

arithmetic addition operator or 
autoincrement indicator 

arithmetic subtraction operator 
or autodecrement indicator 

arithmetic multiplication operator 

arithmetic division operator 

logical AND operator 

logical inclusive OR operator 

double ASCII character indicator 

single ASCII character indicator 

universal operator, 
argument indicator 

macro numeric argument indicator 


\ 


3.1.1 Separating and Delimiting Characters 

Reference is made in the remainder of the manual to legal separating 
characters and legal argument delimiters. These terms are defined in 
Tables 3-1 and 3-2. 
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Table 3-1 

Legal Separating Characters 


Character 

Definition 

Usage 

space 

one or more spaces 

A space is a legal separator only 


and/or tabs 

for argument operands. Spaces 

within expressions are ignored. 


comma 

A comma is a legal separator for 
both expressions and the argument 
operands . 


Table 3-2 

Legal Delimiting Characters 


Character 

Definition 

Usage 

< . 

. . > 

paired angle brackets 

Paired angle brackets are 

used to 




enclose an argument, particularly 




when that argument 

contains 




separating characters. 

Paired 




angle brackets may be used 

anywhere 




in a program to enclose an 

expression for treatment as a term. 

+\- 

• A 

Up arrow construction 

This construction is equivalent in 



where the up arrow 

function to the paired 

angle 



character is followed 

brackets and is generally 

used only 



by an argument 

where the argument contains angle 



bracketed by any 
paired printing 
characters . 

brackets . 



Where argument delimiting characters are used, they must bracket the 
first (and, optionally, any following) argument(s). The character < 
and the characters t\ , where \ is any printing character, can be 
considered unary operators which cannot be immediately preceded by 
another argument. For example: 

.MACRO TEM <AB>C 

indicates a macro definition with two arguments, while 
.MACRO TEL C<AB> 

has only one argument. The closing >, or matching character where the 
up arrow construction is used, acts as a separator. The opening 
argument delimiter does not act as an argument separator. 

Angle brackets can be nested as follows: 

<A<B>C> 

which reduces to: 

A<B>C 

and is considered to be one argument in both forms. 
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3.1.2 Illegal Characters 

A character can be illegal in one of two ways: 

1. A character which is not recognized as an element of the 
MAC 1 1 character set is always an illegal character and causes 
immediate termination of the current line at that point, plus 
the output of an error flag in the assembly listing. For 
example : 

LABEL-*-: MOV A , B 

Since the backarrow is not a recognized character, the entire 
line is treated as a: 

.WORD LABEL 

statement and is flagged in the listing. 

2. A legal MACH character may be illegal in context. Such a 
character generates a Q error on the assembly listing. 


3.1.3 Operator Characters 

Legal unary operators under MACH are as follows: 
Unary 


Operator Explanation 


Example 


+ plus sign 

+A 

(positive value of A, 

equivalent to A) 

minus sign 

-A 

(negative , 
value of A) 

2's complement. 

+ up arrow. 

"C24 (8) 

( interprets 

the l's complement 

universal unary 


value of 24 ( 

8) ) 

operator (this 

usage is described 
in greater detail 

"D127 

( interprets 
number ) 

127 as a decimal 

in Section 5.4.2) . 


"034 

( interprets 
number ) 

34 as an octal 


"B11000111 

( interprets 
binary value 

11000111 as a 

) 

The unary operators as desc 

ribed above 

can be used 

adjacent to each 


other in a term. For example: 
-% 5 

+C1012 
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Legal binary operators under MACH are as follows: 
Binary 


Operator 

Explanation 


Example 


+ 

add i t ion 

A+B 



- 

subtraction 

A-B 



* 

multiplication 

A*B 

(16-bit 

product returned) 

/ 

division 

A/B 

(16-bit 

quotient returned) 

& 

logical AND 

A&B 



i 

logical inclusive OR 

A! B 




All binary operators have the same priority. Items can be grouped for 
evaluation within an expression by enclosure in angle brackets. Terms 
in angle brackets are evaluated first, and remaining operations are 
performed left to right. For example: 

.WORD 1+2*3 ; IS 11 OCTAL 

•WORD l+<2*3> ; IS 7 OCTAL 

3.2 MACH SYMBOLS 

There are three types of symbols: permanent, user-defined and macro. 

f MACll maintains three types of symbol tables: the Permanent Symbol 

Table (PST) , the User Symbol Table (UST) and the Macro Symbol Table 
(MST) . The PST contains all the permanent symbols. The UST and MST 
are constructed as the source program is assembled; user-defined 
symbols are added to the table as they are encountered. 


3.2.1 Permanent Symbols 

Permanent symbols consist of the instruction mnemonics (Appendix B.3) 
and assembler directives (Chapters 5 and 6, Appendix B.4). These 
symbols are a permanent part of the Assembler and need not be defined 
before being used in the source program. 




3.2.2 User-Defined and MACRO Symbols 

User-defined symbols are those used as labels (Section 2.1.1) or 
defined by direct assignment (Section 3.3). These symbols are added 
to the User Symbol Table as they are encountered during the first pass 
of the assembly. Macro symbols are those symbols used as macro names 
(Section 6.1). These symbols are added to the Macro Symbol Table as 
they are encountered during the assembly. 

User-defined and macro symbols can be composed of alphanumeric 
characters, dollar signs, and periods only; any other character is 
illegal . 


The following rules apply to the creation of user-defined and macro 
symbols : 


1. The first character must not be a number. 


2. Each symbol must be unique within the first six characters. 


3. 


A symbol can be written with more than six legal characters, 
but the seventh and subsequent characters are only checked 
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for legality, and are not otherwise recognized by the 
Assembler . 

4. Spaces, tabs, and illegal characters must not be embedded 
within a symbol. 

The value of a symbol depends upon its use in the program. A symbol 
in the operator field may be any one of the three symbol types. To 
determine the value of the symbol, the Assembler searches the three 
symbol tables in the following order: 

1. Macro Symbol Table 

2. Permanent Symbol Table 

3. User-defined Symbol Table 

A symbol found in the operand field is sought in the 

1. User-defined Symbol Table 

2. Permanent Symbol Table 

in that order. The Assembler never expects to find a macro name in an 
operand field. 

These search orders allow redefinition of Permanent Symbol Table 
entries as user-defined or macro symbols. The same name can also be 
assigned to both a macro and a label. 

All user-defined symbols are internal and must be defined within the 
current assembly. 


3.3 DIRECT ASSIGNMENTS 

A direct assignment statement associates a symbol with a value. When 
a direct assignment statement defines a symbol for the first time, 
that symbol is entered into the user symbol table and the specified 
value is associated with it. A symbol may be redefined by assigning a 
new value to a previously defined symbol. The latest assigned value 
replaces any previous value assigned to a symbol. 


The general format for a direct assignment statement is: 
symbol = expression 


Symbols take 
For example: 

on the absolute attribute of their 

defining expression. 


A = 1 ; THE SYMBOL A 

; VALUE 1. 

IS EQUATED 

TO THE 


B= ' A-l &MASKLOW ; THE SYMBOL B 

; VALUE OF THE 

IS EQUATED TO 
EXPRESSION. 

THE 

C: 

D = 3 

; THE SYMBOL D 

IS EQUATED TO 

3. 

E: 

MOV #1 ,ABLE 

; LABELS C AND 

E ARE EQUATED 

TO THE 


; LOCATION OF THE MOV COMMAND. 
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The following conventions apply to direct assignment statements: 

1. An equal sign (=) must separate the symbol from the 

expression defining the symbol value. 

2. A direct assignment statement is usually placed in the 

operator field and may be preceded by a label and followed by 
a comment. 

3. Only one symbol can be defined by any one direct assignment 
statement . 

4. Only one level of forward referencing is allowed. 

Example of two levels of forward referencing (illegal): 

X = Y 
Y = Z 
Z = 1 

X and Y are both undefined throughout pass 1. X is undefined 

throughout pass 2 and causes a U error flag in the assembly listing. 


3.4 REGISTER SYMBOLS 

The eight general registers of the PDF-11 are numbered 0 through 7 and 
can be expressed in the source program as: 

%0 

%1 


% 7 

where the digit indicating the specific register can be replaced by 
any legal term which can be evaluated during the first assembly pass. 

It is recommended that the programmer create and use symbolic names 
for all register references. A register symbol is defined in a direct 
assignment statement, among the first statements in the program. The 

defining expression of a register symbol must be absolute. For 
example : 


000000 R0 = % 0 ; REGISTER DEFINITION 

000001 Rl=% 1 

000002 R2=%2 

000003 R3=%3 

000004 R4=%4 

000005 R5 = % 5 

000006 R6=%6 

000006 SP=%6 

000007 PC=%7 

000007 R7=%7 


The symbolic names assigned to the registers in the example above are 
the conventional names used in all PDP-11 system programs. Since 
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these names are fairly mnemonic, it is suggested the user follow this 
convention. Registers 6 and 7 are given special names because of 
their special functions, while registers 0 through 5 are given similar 
names to denote their status as general purpose registers. 

All register symbols must be defined before they are referenced. A 
forward reference to a register symbol is flagged as an error. 

The % character can be used with any term or expression to specify a 
register. (A register expression less than 0 or greater than 7 is 
flagged with an R error code.) For example: 

CLR % 3 + 1 

is equivalent to 
CLR %4 

and clears the contents of register 4, while 
CLR 4 

clears the contents of memory address 4. 

In certain cases a register can be referenced without the use of a 
register symbol or register expression; these cases are recognized 
through the context of the statement. An example is shown below: 

JSR 5 , SUBR ; FIRST OPERAND FIELD MUST ALWAYS BE A REGISTER 


3.5 LOCAL SYMBOLS 

Local symbols are specially formatted symbols used as labels within a 
given range. Use of local symbols can achieve considerable savings in 
core space within the user symbol table. Core cost is one word for 
each local symbol in each local symbol block, as compared with four 
words of storage for each label stored in the user symbol table. 

Local symbols provide a convenient means of generating labels for 
branch instructions, etc. Use of local symbols reduces the 
possibility of multiply-defined symbols within a user program and 
separates entry point symbols from local references. Local symbols 
are not referenced from outside their local symbol block. 

Local symbols are of the form n$ where n is a decimal integer from 1 
to 127, inclusive, and can only be used on word boundaries. Local 
symbols include: 

1 $ 

27$ 

59$ 

104$ 

Within a local symbol block, local symbols can be defined and 
referenced. However, a local symbol cannot be referenced outside the 
block in which it is defined. There is no conflict with labels of the 
same name in other local symbol blocks. 
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Local symbols 64$ through 127$ can be generated automatically as a 
feature of the macro processor {see Section 6.3.5 for further 
details). When using local symbols, the user is advised to first use 
the range from 1 $ to 63$. 

A local symbol block is delimited in one of the following ways: 

1. The range of a single local symbol block can consist of those 
statements between two normally constructed symbol labels. 
(Note that a statement of the form 

LABEL= . 


is a direct assignment, does not create a label in the strict 
sense, and does not delimit a local range.) 


2. 

The range of 

a single 

local symbol block can be 

delimited 


with the 

ENABL LSB 

and the first symbolic 

label . The 

default for 
For examples of local 

LSB is off. 

symbols and local symbol blocks, see 

Figure 3-3. 

Ln . 
No . 

Octal 

Expansion 

Source 

Code Comments 


:l. 

•••) 

3 

0 0 0 0 0 0 R 0 ; % 

•i 

, SBTTL 

SECTOR INITIALIZATION 


4 

5 000000 

XL TP 

RG i 

? PROGRAM .1. 

■i I T I A I... I Z A J I 

■k 000000 

01 2700 

H00 

* IMPURE i RO 


7 000004 

000044 

CL.R 

(E0>+ ? CLEAR IMP 

JRE AREA .> 

3 000006 

022700 

CMP 

# I MP TOP v RO 


9 0000.1.2 

000046 
10. 1.37 4 

BH 1. 

1. it 


1.0 000. u 

XCTP 

OS 1 

4 PASS I NIT 

TAI ! 7 A T T ON 

.11 000 1 4 

0:1.2700 

MOO 

ttlMPASByRO 


1 2 00020 

000050 
005020 :l. <i; J 

CLP 

{ ^ •, •, . J.. 


.13 0 0022 

022700 

CMP 

# I HP TOP v RO 


14 00026 

000046 
1.0 .1.374 

BH T 

;j <|: 


15 00030 

XCTL 

I N i 

5 LINE I NIT 

lALI'ZAT ION .. 

1 & 000 ,50 

0 1 2 7 0 0 

MOV 

# I MPL I N ■' RO 



000052 




1 / 'jOuil 

0 L.i \ 1 7. I- 1 

.... k 

K v ) + 


1.8 0*0036 

0 2 2 7 0 0 

CMP 

# I MP TOP > RO 


19 00042 

0 0 0 0 4 6 
1. 0 1374 

BUI 

1 $ 



Figure 3-1 

Assembly Source Listing of MACH Code 
Showing Local Symbol Blocks 
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The maximum offset of a local symbol from the base of its local symbol 
blocks is 128 decimal words. Symbols beyond this range are flagged 
with an A error code. 


3.6 ASSEMBLY LOCATION COUNTER 

The period (.) is the symbol for the assembly location counter. When 
used in the operand field of an instruction, it represents the address 
of the first word of the instruction. When used in the operand field 
of an assembler directive, it represents the address of the current 
byte or word. For example: 

A: MOV #.,R0 ;. REFERS TO LOCATION A, 

; I . E . , THE ADDRESS OF THE 
; MOV INSTRUCTION. 

(# is explained in Section 4.9.) 

At the beginning of each assembly pass, the Assembler clears the 
location counter. Normally, consecutive memory locations are assigned 
to each byte of binary data generated. However, the location of the 
stored binary data may be changed by a direct assignment altering the 
location counter. 

. =expression 

The expression defining the location counter must not contain forward 
references or symbols that vary from one pass to another. 

Examples : 


.=500 


SET LOCATION COUNTER TO ABSOLUTE 
500 


FIRST: MOV .+10, COUNT 


THE LABEL FIRST HAS THE VALUE 500(8) 
.+10 EQUALS 510(8). THE CONTENTS OF 
THE LOCATION 510(8) WILL BE DEPOSITED 
IN LOCATION COUNT. 


.=520 ; THE ASSEMBLY LOCATION COUNTER NOW 

; HAS A VALUE OF ABSOLUTE 520(8). 

SECOND: MOV ., INDEX ; THE LABEL SECOND HAS THE VALUE 520(8) 

; THE CONTENTS OF LOCATION 520(8), THAT 
; IS , THE BINARY CODE FOR THE INSTRUCTION 
; ITSELF, WILL BE DEPOSITED IN LOCATION 
; INDEX. 


. = .+20 


SET LOCATION COUNTER TO ABSOLUTE 540 OF 
THE PROGRAM SECTION. 


THIRD: .WORD 0 


THE LABEL THIRD HAS THE VALUE OF 
ABSOLUTE 540. 


3-10 



SYMBOLS AND EXPRESSIONS 


Storage area may be reserved by advancing the location counter. For 
example, if the current value of the location counter is 1000, the 
direct assignment statement 


.=.+100 


reserves 100(8) bytes of storage space in the program. The next 
instruction is stored at 1100. 


3.7 NUMBERS 

The MAC 11 Assembler assumes all numbers in the source program are to 
be interpreted in octal radix unless otherwise specified. The assumed 
radix can be altered with the .RADIX directive (see Section 5.4.1) or 
individual numbers can be treated as being of decimal, binary, or 
octal radix (see Section 5.4.2). 

Octal numbers consist of the digits 0 through 7 only. A number not 
specified as a decimal number and containing an 8 or 9 is flagged with 
an N error code and treated as a decimal number. 

Negative numbers are preceded by a minus sign (the Assembler 
translates them into 2's complement form). Positive numbers may be 
preceded by a plus sign, although this is not required. 

A number which is too large to fit into 16 bits (177777<n) is 
truncated from the left and flagged with a T error code in the 
assembly listing. 


3.8 TERMS 

A term is a component of an expression. A term may be one of the 
following : 

1. A number, as defined in Section 3.7, whose 16-bit value is 
used . 

2. A symbol, as defined earlier in the chapter. Symbols are 
interpreted according to the following hierarchy: 

a. a period causes the value of the current location counter 
to be used . 

b. a permanent symbol whose basic value is used and whose 
arguments (if any) are ignored. 

c. an undefined symbol is assigned a value of zero and 
inserted in the user-defined symbol table. 

3. An ASCII conversion using either an apostrophe followed by a 
single ASCII character or a double quote followed by two 
ASCII characters which results in a word containing the 7-bit 
ASCII value of the char acter ( s) . (This construction is 
explained in greater detail in Section 5.3.3.) 

4. A term may also be an expression or term enclosed in angle 
brackets. Any quantity enclosed in angle brackets is 
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evaluated before the remainder of the expression in which it 
is found. Angle brackets are used to alter the left to right 
evaluation of expressions (to differentiate between A*B+C and 
A* < B+C > ) or to apply a unary operator to an entire expression 
( -<A+B> , for example). 


3.9 EXPRESSIONS 

Expressions are combinations of terms joined together by binary 
operators and which reduce to a 16-bit value. The operands of a .BYTE 
directive (see Section 5.3.1) are evaluated as word expressions before 
truncation to the low-order eight bits. Prior to truncation, the 
high-order byte must be zero or all ones (when byte value is negative, 
the sign bit is propagated) . 

Expressions are evaluated left to right with no operator hierarchy 
rules except that unary operators take precedence over binary 
operators. A term preceded by a unary operator can be considered as 
containing that unary operator. (Terms are evaluated, where 
necessary, before their use in expressions.) Multiple unary operators 
are valid and are treated as follows: 

-h — A 

is equivalent to 

-<+<-A>> 

A missing term, expression, or external symbol is interpreted as a 
zero. A missing operator is interpreted as +. A Q error flag is 
generated for each missing term or operator. For example: 

TAG: LA 177777 

is evaluated as 

TAG: LA+177777 

with a Q error flag on the assembly listing line. 

The value of an expression is the value of the absolute part of the 
expression ; e .g . , 

A = 5 
. = 20 

TAG: MOV TAG+A , R0 ;SET R0 TO 25 (8). 
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ADDRESSING MODES 


The program counter 
always contains the 
address of the next 
word of the current 


(PC, register 7 of the eight 
address of the next word to be 
instruction to be executed, or 
instruction . 


general registers) 
fetched ; i .e . , the 
the second or third 


In order to understand how the address modes operate and how they 
assemble, the action of the program counter must be understood. The 
key rule is: 

Whenever the processor implicitly uses 
the program counter to fetch a word from 
memory, the program counter is 
automatically incremented by two after 
the fetch. 

That is, when an instruction is fetched, the PC is incremented by two, 
so that it is pointing to the next word in memory; and, if an 
instruction uses indexing (Sections 4.7, 4.8 and 4.11) the processor 
uses the program counter to fetch the base from memory. Hence, using 
the rule above, the PC increments by two, and now points to the next 
word . 


The following conventions are used in this Section: 

1. Let E be any expression as defined in Chapter 3. 

2. Let R be a register expression. This is any expression 

containing a term preceded by a % character or a symbol 

previously equated to such a term. 

Examples : 

RO = %0 ,-GENERAL REGISTER 0 

R1 = RO+1 ; GENERAL REGISTER 1 

R2 = 1+%1 ;GENERAL REGISTER 2 

3. Let ER be a register expression or an expression in the range 
0 to 7 inclusive. 

4. Let A be a general address specification which produces a 

6-bit mode address field as described in Sections 3.1 and 3.2 

of the PDP-11 Processor Handbook. 

The addressing specifications. A, can be explained in terms of E, R, 
and ER as defined above. Each is illustrated with the single operand 
instruction CLR or double operand instruction MOV. 
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4.1 REGISTER MODE 

The register contains the operand. 

Format for A: R 

Examples: R0=%0 ; DEFINE RO AS REGISTER 0 

CLR RO ; CLEAR REGISTER 0 


4.2 REGISTER DEFERRED MODE 

The register contains the address of the operand. 

Format for A: @R or (ER) 

Examples: CLR @R1 ; BOTH INSTRUCTIONS CLEAR 

CLR (1) ; THE WORD AT THE ADDRESS 

; CONTAINED IN REGISTER 1 


4.3 AUTOINCREMENT MODE 

The contents of the register are incremented immediately after being 
used as the address of the operand. (See note below.) 

Format for A: (ER)+ 


Examples : 


CLR ( RO ) + 
CLR (RO + 3) + 
CLR ( 2 ) + 


EACH INSTRUCTION CLEARS 
THE WORD AT THE ADDRESS 
CONTAINED IN THE 
SPECIFIED REGISTER AND 
INCREMENTS THAT 
REGISTER'S CONTENTS BY 
TWO. 


t 


NOTE 

Both JMP and JSR instructions using 
non-deferred autoincrement mode, 

autoincrement the register before its 
use on the PDP-11/20 but afterwords on 
the PDP-11/45 or 11/05. In double 
operand instructions of the addressing 
form %R,(R)+ or %R,-(R) where the source 
and destination registers are the same, 
the source operand is evaluated as the 
autoincremented or autodecremented 
value; but the destination register, at 
the time it is used, still contains the 
originally intended effective address. 
In the following two examples, as 
executed on the PDP-11/20, RO originally 
contains 100. 

MOV RO , ( 0 ) + ; THE QUANTITY 102 IS 

; MOVED TO LOCATION 100 
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MOV RO , - ( 0 ) ; THE QUANTITY 76 IS MOVED 
; TO LOCATION 76 

The use of these forms should be avoided 
as they are not compatible across the 
PDP-11 family. 


A Z error code 
compatible among 
warning code. 


is printed with each instruction which is not 
all members of the PDP-11 family. This is merely a 


4.4 AUTOINCREMENT DEFERRED MODE 


The register contains the pointer to the address of the operand. The 
contents of the register are incremented after being used. 


Format for A: @(ER)+ 

Example: CLR @(3)+ 


CONTENTS OF REGISTER 3 
POINT TO ADDRESS OF WORD 
TO BE CLEARED BEFORE 
BEING INCREMENTED BY TWO 


4.5 AUTODECREMENT MODE 


The contents of the register are decremented before being used as the 
address of the operand {see note under autoincrement mode). 


Format for A: ~{ER) 


Examples: CLR -(RO) 

CLR - { RO+3 ) 
CLR -(2) 


DECREMENT CONTENTS OF 
REGISTERS 0, 3, AND 2 BY 
TWO BEFORE USING AS 
ADDRESSES OF WORDS TO BE 
CLEARED. 


4.6 AUTODECREMENT DEFERRED MODE 

The contents of the register are decremented before being used as the 
pointer to the address of the operand. 

Format for A: @-(ER) 

Example: CLR @-(2) ; DECREMENT CONTENTS OF 

; REGISTER 2 BY TWO BEFORE 
; USING AS POINTER TO 
; ADDRESS OF WORD TO BE 
; CLEARED . 


4.7 INDEX MODE 

The value of an expression E is stored as the second or third word of 
the instruction. The effective address is calculated as the value of 
E plus the contents of register ER. The value E is called the base. 
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Format for A: 


ADDRESSING MODES 
E (ER) 


Examples : 


CLR X+2 ( R1 ) 


CLR -2(3) 


EFFECTIVE ADDRESS IS X+2 
PLUS THE CONTENTS OF 
REGISTER 1. 

EFFECTIVE 

ADDRESS IS -2 PLUS THE 
CONTENTS OF REGISTER 3. 


4.8 INDEX DEFERRED MODE 


An expression plus the 
address of the operand. 

Format for A: 

Example : 


contents of a register 

@E (ER) 

CLR @14(4) 


gives the pointer to the 


IF REGISTER 4 HOLDS 100 
AND LOCATION 114 HOLDS 
2000, LOCATION 2000 IS 
CLEARED. 


4.9 IMMEDIATE MODE 

The immediate mode allows the operand itself to be stored as the 
second or third word of the instruction. It is assembled as an 
autoincrement of register 7, the PC. 

Format for A: #E 

Examples: MOV #100, R0 ; MOVE AN OCTAL 100 TO 

MOV #X, R0 ; REGISTER 0. MOVE THE 

; VALUE OF SYMBOL X TO 
; REGISTER 0. 

The operation of this mode is explained as follows. 

The statement MOV #100, R3 assembles as two words. These are: 

0 1 2 7 0 3 
0 0 0 1 0 0 

Just before this instruction is fetched and executed, the PC points to 
the first word of the instruction. The processor fetches the first 
word and increments the PC by two. The source operand mode is 27 
(autoincrement the PC) . Thus the PC is used as a pointer to fetch the 
operand (the second word of the instruction) before being incremented 
by two, to point to the next instruction. 

4.10 ABSOLUTE MODE 


Absolute mode is the equivalent of immediate mode deferred. @#E 
specifies an absolute address which is stored in the second or third 
word of the instruction. Absolute mode is assembled as an 
auto increment deferred of register 7, the PC. 


Format for A: @#E 


Examples : 


MOV @ # 100 , R0 
CLR @#X 


MOVE THE VALUE OF THE 
CONTENTS OF LOCATION 100 
TO REGISTER 0. CLEAR 
THE CONTENTS OF THE 
LOCATION WHOSE ADDRESS 
IS X. 
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4.11 RELATIVE MODE 

Relative mode is the normal mode for memory references. 

Format for A: E 

Examples: CLR 100 ; CLEAR LOCATION 100. 

MOV X , Y ; MOVE CONTENTS OF 

; LOCATION X TO LOCATION 
;Y. 

Relative mode is assembled as index mode, using register 7, the PC, as 
the index register. The base of the address calculation, which is 
stored in the second or third word of the instruction, is not the 
address of the operand (as in index mode), but the number which, when 
added to the PC, becomes the address of the operand. Thus, the base 
is X-PC , which is called an offset. The operation is explained as 
follows : 

If the statement MOV 100, R3 is assembled at absolute location 20, the 
assembled code is: 

Location 20: 016703 

Location 22: 000054 

The processor fetches the MOV instruction and adds two to the PC so 
that it points to location 22. The source operand mode is 67; that 
is, indexed by the PC. To pick up the base, the processor fetches the 
word pointed to by the PC and adds two to the PC. The PC now points 
to location 24. To calculate the address of the source operand, the 
base is added to the designated register. That is, BASE+PC=54+24=100 , 
the operand address. 

Since the Assembler considers as the address of the first word of 

the instruction, an equivalent index mode statement would be: 

MOV 100-.-4 (PC) ,R3 

This mode is called relative because the operand address is calculated 
relative to the current PC. The base is the distance or offset (in 
bytes) between the operand and the current PC. If the operator and 
its operand are moved in memory so that the distance between the 
operator and data remains constant, the instruction will operate 
correctly anywhere in core. 


4.12 RELATIVE DEFERRED MODE 


Relative deferred mode is similar to relative mode, except that the 
expression, E, is used as the pointer to the address of the operand. 


Format for A: @E 

Example: MOV @X,R0 


MOVE THE CONTENTS OF THE 
LOCATION WHOSE ADDRESS IS 
IN X INTO REGISTER 0. 


4.13 TABLE OF MODE FORMS AND CODES 

Each instruction takes at least one word. Operands of the first six 
forms listed below do not increase the length of an instruction. Each 
operand in one of the other modes, however, increases the instruction 
length by one word. 
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where n is 
Any of the 


where n is 
register 7 


Form 

Mode 

Meaning 



R 

On 

Register mode 



@ R or (ER) 

In 

Register deferred mode 


( ER) + 

2n 

Autoincrement 

mode 


0 ( ER) + 

3n 

Autoincrement 

deferred 

mode 

-(ER) 

4n 

Autodecrement 

mode 


0- ( ER) 

5n 

Autodecrement 

deferred 

mode 


the register 

number . 


following forms adds 

one word to the instruction length 

Form 

Mode 

Meaning 

E (ER) 

6n 

Index mode 

@E (ER) 

7n 

Index deferred mode 

#E 

27 

Immediate mode 

0 # E 

37 

Absolute memory reference mode 

E 

67 

Relative mode 

@ E 

77 

Relative deferred reference mode 


the register number. Note that in the last four forms, 
(the PC) is referenced. 


NOTE 

1. An alternate form for @F is (ER) . 
However, the form @(ER) is equivalent to 
@0 (ER) . 

2. The form @#E differs from the form E in 
that the second or third word of the 
instruction contains the absolute 
address of the operand rather than the 
relative distance between the operand 
and the PC. Thus, the instruction 
CLR @#100 clears absolute location 100 
even if the instruction is moved from 
the point at which it was assembled. 


4.14 BRANCH INSTRUCTION ADDRESSING 

The branch instructions are 1-word instructions. The high byte 
contains the op code and the low byte contains an 8-bit signed offset 
(7 bits plus sign) which specifies the branch address relative to the 
PC. The hardware calculates the branch address as follows: 

1. Extend the sign of the offset through bits 8-15. 

2. Multiply the result by 2. This creates a word offset rather 
than a byte offset. 

3. Add the result to the PC to form the final branch address. 

The Assembler performs the reverse operation to form the byte offset 
from the specified address. Remember that when the offset is added to 
the PC, the PC is pointing to the word following the branch 
instruction; hence the factor -2 in the calculation. 

Byte offset = (E-PC)/2 truncated to eight bits. 
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Since PC = .+2, we have 

Byte offset = (E-.-2)/2 truncated to eight bits. 

The EMT and TRAP instructions do not use the low-order byte of the 
word. This allows information to be transferred to the trap handlers 
in the low order byte. If EMT or TRAP is followed by an expression, 
the value is put into the low-order byte of the word. However, if the 
expression is too big (>377(8)) it is truncated to eight bits and a T 
error flag is generated. 
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CHAPTER 5 


GENERAL ASSEMBLER DIRECTIVES 


5.1 LISTING CONTROL DIRECTIVES 


5.1.1 .LIST and . NLIST 

Listing options can be specified in the text of a MACH program 
through the .LIST and .NLIST directives. These are of the form: 

.LIST arg 
.NLIST arg 

where : 

arg represents one or more optional arguments. 

When used without arguments, the listing directives alter the listing 
level count. The listing level count causes the listing to be 
suppressed when it is negative. The count is initialized to zero, 
incremented for each .LIST and decremented for each .NLIST. For 
example : 

.MACRO LTEST ;LIST TEST 

; A-THIS LINE SHOULD LIST 
.NLIST 

; B-THIS LINE SHOULD NOT LIST 
.NLIST 

;C-THIS LINE SHOULD NOT LIST 
.LIST 

; D-THIS LINE SHOULD NOT LIST (LEVEL NOT BACK TO ZERO) 

.LIST 

; E-TH I S LINE SHOULD LIST (LEVEL BACK TO ZERO) 

. ENDM 

; LTEST ; CALL THE MACRO 

; A-THIS LINE SHOULD LIST 
.NLIST 
.LIST 

; E-THIS LINE SHOULD LIST (LEVEL BACK TO ZERO) 

The primary purpose of the level count is to allow macro 
expansions to be selectively listed and yet exit with the level 
returned to the status current during the macro call. 

The use of arguments with the listing directives does not affect 
the level count; however, use of .LIST and .NLIST can be used to 
override the current listing control. For example: 
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.MACRO XX 

.LIST ; LIST NEXT LINE 

X= . 



. NLIST 

; DO NOT LIST REMAINDER 
; OF MACRO EXPANSION 


. ENDM 
.NLIST ME 
XX 

. LIST 
X= . 

; DO NOT LIST MACRO EXPANSIONS 
; LIST NEXT LINE 

Allowable arguments for 
(these arguments can be 

use with the listing directives are as follows 
used singly or in combination) : 

Argument 

Default 

Function 

SEQ 


list 

Controls the listing of source line sequence 
numbers. Error flags are normally printed on 
the line preceding the questionable source 
statement . 

LOC 


list 

Controls the listing of the location counter 
(this field would not normally be 
suppressed) . 

BIN 


list 

Controls the listing of generated binary 
code . 

BEX 


list 

Controls listing of binary extensions; that 
is, those locations and binary contents 
beyond the first binary word (per source 
statement) . This is a subset of the BIN 
argument . 

SRC 


list 

Controls the listing of the source code. 

COM 


list 

Controls the listing of comments. This is a 
subset of the SRC argument and can be used to 
reduce listing time and/or space where 
comments are unnecessary. 

MD 


list 

Controls listing of macro definitions and 
repeat range expansions. 

MC 


list 

Controls listing of macro calls and repeat 
range expressions. 

ME 


no list 

Controls listing of macro expansions. 

MEB 


no list 

Controls listing of macro expansion binary 
code. A .LIST MEB causes only those macro 
expansion statements producing binary code to 
be listed. This is a subset of the ME 
argument . 
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Argument 

CND 


LD 


TOC 


TTM 


SYM 


Default 


Function 


list 


no list 


list 


Teletype 

mode 


list 


Controls the listing of 
conditions and all .IF and . ENDC 
This argument permits conditional 
to be listed without including 
code . 


unsatisfied 
statements . 

assembl ies 
unsatisfied 


Control listing of all listing directives 
having no arguments (those used to alter the 
listing level count). 


Control listing of tables of contents on pass 
1 of the assembly (see Section 5.1.4 
describing the .SBTTL directive). The full 
assembly listing is printed during pass 1 of 
the assembly. 


Controls listing output format. The TTM 
argument (the default case) causes output 
lines to be truncated to 72 characters. 
Binary code is printed with the binary 
extensions below the first binary word. The 
alternative (.NLIST TTM) to Teletype mode is 
line printer mode, which is shown in Figure 
5-1. 

Controls the listing of the symbol table for 
the assembly. 


An example of an assembly listing is shown in Figure 5-1. 


5.1.2 Page Headings 

The MAC 11 Assembler outputs each page in the format shown in Figure 
5-1, Line Printer Listing. On the first line of each listing page the 
Assembler prints (from right to left): 


1 . 

title taken from 

.TITLE directive 

2. 

assembler version 

identification 

3. 

page number . 



The second line of each listing page contains the subtitle text 
specified in the last encountered .SBTTL directive. 


5.1.3 .TITLE 

The .TITLE directive is used to assign a name to the listing output. 
The name is the first symbol following the directive and must be six 
Radix-50 characters or less (any characters beyond the first six are 
ignored). Non-Radix 50 characters are not acceptable. For example: 

.TITLE PROG TO PERFORM DAILY ACCOUNTING 

causes the listing output of the assembled program to be named PROG 
(this name is distinguished from the filename of the binary output 
specified in the command string to the Assembler). 
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PIREX.149 MACH XVM V1A000 PAGE 29 

LINE PRINTER DRIVER FUR LP11/15 

1 : LP INTERRUPT ENTRANCE 

2 


3 

OU 7 604 


LPINT : 



4 

007604 

04 2 7 b 7 
000100 
167702 


B 1C 

*100, LPCSR 

5 

007612 

004067 

172222 


JSR 

RO, R.SAVE 

6 

007616 

000004 


4 


7 

007620 

016700 

177510 


MU V 

LP-2.R0 

8 

q 

007624 

001511 


Bt'Q 

LPXT 

7 

10 

0 7626 

005767 

167662 


tst 

LPCSR 

1 1 

0 7 6 3 2 

100454 


BMl 

LPERR 

12 

07634 

005067 
1 7 1 5b0 


CLR 

LP , CL 

13 

07 b40 


LPLOP: 



14 

07640 

105767 

167650 


I STB 

LPCSR 

15 

07b44 

100043 


BPL 

LPSTIL 

lb 

07646 

105767 

000342 


TSTB 

LPT AB 

1 7 

0 7 bb 2 

100421 


BMl 

4$ 

18 

07654 

005367 

000332 


OfcC 

LPBTCT 

19 

07660 

100424 


Si’ll 

5S 

20 

07662 

105777 

000322 


TSTB 

gLPBUFF 

21 

0 7 b 6 6 

10040o 


BMl 

6 S 

22 

0 7 6 7 0 

117767 

000314 

167620 


MU VB 

RLPBUFF , LPHUF 

23 

07676 

005267 

000306 


IiMC 

LPBUFF 

24 

07702 

000756 


BR 

LPLOP 

25 



; 



26 

07704 

117767 

000300 

000302 

b$ : 

MOVB 

@LPBUFF , LPTAB 

27 

0 7 7 1 2 

005267 

000272 


1 iMC 

LPBUFF 

28 

077 1b 

105267 

000272 

4S : 

1 NCB 

LPTAB 

29 

07722 

112767 

000040 

16756b 


MO VB 

K40.LPBUF 

30 

07730 

000743 


BR 

LPLUP 

31 

0 77 32 

1 05 7o 7 
000260 

5$: 

TSTB 

LPEUL 

32 

07736 

001403 


BLQ 

7S 

33 

07740 

116767 


MO VB 

LPEOL , LPBUF 


; DISABLE LP INTERRUPT 


;SAVE REGISTERS 

; TASK CUDE 
; GET TCB POINTER 

; IGNORE IF ITS ALREADY BEEN STOPPED BY 
J A STOP I/O REQUEST. 

.•CHECK FOR ERROR 

; YES 

.•CLEAR OUT ANY PENDING TIMER REQUEST FOR US. 


;IS PRINTER CURRENTLY GOING? 

; YES : FORGET CHAR FOR NUN 

; IN TAb EXPANSION TO SPACES? 

; YES 

; OECR CHAR COUNT 

;n£nT l'U -1, MAKE CR TO finish LINE 
; MINUS BYTE IS TAB EXPANSION COUNT 

IS ONE, GO SET UP 

.•STICK CHAR INTO LINE PRINTER BUFFER 


.•MOVE POINTER TO NEXT CHAR 
; GO DO NEXT 

; SET UP TAB COUNT (MINUS, A LA 15) 


.•COUNT A SPACE FOR THIS TAB 
.•SPACE TO LINE PRINTER 


; GO DO NEXT 
.•IMAGE OR ASCII 

JIMAGE, DON'T FORCE <CR> 

.•ASCII, HERE IS <CARRIAGE RETURN) 


Figure 5-1 

Example of MACH Line Printer Listing 
(132-column line printer) 
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If there is no .TITLE statement, the default name assigned to the 
first listing output is 

.MAIN. 

The first tab or space following the .TITLE directive is not 
considered part of the listing output name or header text, although 
subsequent tabs and spaces are significant. 

If there is more than one .TITLE directive, the last .TITLE directive 
in the program conveys the name of the listing output. 


5.1.4 . SBTTL 

The .SBTTL directive is used to provide the elements for a printed 
table of contents of the assembly listing. The text following the 
directive is printed as the second line of each of the following 
assembly listing pages until the next occurrence of a .SBTTL 
directive. For example: 

•SBTTL CONDITIONAL ASSEMBLIES 


The text 


CONDITIONAL ASSEMBLIES 

is printed as the second line of each of the following assembly 
listing pages. 

During pass 1 of the assembly process, MACH automatically prints a 
table of contents for the listing containing the line sequence number 
and text of each .SBTTL directive in the program. 

An example of the table of contents is shown in Figure 5-2. Note that 
the first word of the subtitle heading is not limited to six 
characters since it is not a module name. 
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MACRO 

VIA 

MACRO VIA 




TABLE OF CONTENTS 


5- 

1 

SECTOR INITIALIZATION 


7- 

1 

SUBROUTINE CALL DEFINITIONS 


12- 

1 

PARAMETERS 


14- 

1 

ROLL DEFINITIONS 


16- 

1 

PROGRAM INITIALIZATION 


26- 

1 

ASSEMBLER PROPER 


36- 

1 

STATEMENT PROCESSOR 


40- 

1 

ASSIGNMENT PROCESSOR 


41- 

1 

OP CODE PROCESSOR 


48- 

1 

EXPRESSION TO CODE-ROLL CONVERSIONS 

50- 

1 

CODE ROLL STORAGE 


51- 

1 

DIRECTIVES 


59- 

1 

DATA-GENERATING DIRECTIVES 


68- 

1 

CONDITIONALS 


72- 

1 

LISTING CONTROL 


74- 

1 

ENABL/DSABL FUNCTIONS 


75- 

1 

CROSS REFERENCE HANDLERS 


78- 

1 

LISTING STUFF 


79- 

1 

KEYBOARD HANDLERS 


80- 

1 

OBJECT CODE HANDLERS 


88- 

1 

LISTING OUTPUT 


92- 

1 

I/O BUFFERS 


93- 

1 

EXPRESSION EVALUATOR 


99- 

1 

TERM EVALUATOR 


103- 

1 

SYMBOL/CHARACTER HANDLERS 


109- 

1 

ROLL HANDLERS 


114- 

1 

REGISTER STORAGE 


116- 

1 

MACRO HANDLERS 


135- 

1 

FIN 


Table of Contents text is taken from the 

tex 

directive . 

The associated numbers are the 

pag 1 

numbers 

of 

the .SBTTL directive. 



of each .SBTTL 


Figure 5-2 

Assembly Listing Table of Contents 
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5.1.5 Page Ejection 

There are several means of obtaining a page eject in a MACH assembly 
listing: 

1. After a line count of 58 lines, MACH automatically performs 
a page eject to skip over page perforations on line printer 
paper and to formulate terminal output into pages. 

2. A form feed character used as a line terminator (or as the 
only character on a line) causes a page eject. Used within a 
macro definition a form feed character causes a page eject. 
A page eject is not performed when the macro is invoked. 

3. More commonly, the .PAGE directive is used within the source 
code to perform a page eject at that point. The format of 
this directive is 

.PAGE 

This directive takes no arguments and causes a skip to the 
top of the next page. 

Used within a macro definition, the .PAGE is ignored, but the 
page eject is performed at each invocation of that macro. 


5.2 FUNCTIONS: . ENABL AND . DSABL DIRECTIVES 

Several functions are provided by MACH through the .ENABL and .DSABL 
directives. These directives use 3-character symbolic arguments to 
designate the desired function, and are of the forms: 

.ENABL arg 
.DSABL arg 


where : 


arg is one of the legal symbolic arguments defined below. 


The following table describes the symbolic arguments and their 
associated functions in the MACH language: 


Symbol ic 
Argument 

CDR 


LC 


LSB 


Function 

The statement .ENABL CDR causes source columns 73 and 
greater to be treated as comment. This accommodates 
sequence numbers in card columns 72-80. 

Enabling of this function causes the Assembler to 
accept lower case ASCII input instead of converting it 
to upper case. 

Enable or disable a local symbol block. While a local 
symbol block is normally entered by encountering a new 
symbolic label, .ENABL LSB forces a local symbol block 
which is not terminated until a label following the 
.DSABL LSB statement is encountered. The default case 
is .DSABL LSB. 
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PNC The statement .DSABL PNC inhibits binary output until 

an . ENABL PNC is encountered. The default case is 
. ENABL PNC. 

An incorrect argument causes the directive containing it to be flagged 
as an error . 


5.3 DATA STORAGE DIRECTIVES 

A wide range of data and data types can be generated with the 
following directives and assembly characters: 

.BYTE 

.WORD 


.ASCII 
•ASCIZ 
. RAD50 
+ B 
+ D 
+ 0 

These facilities are explained in the following Sections. 


5.3.1 .BYTE 

The .BYTE directive is used to generate successive bytes of data. The 
directive is of the form: 

.BYTE exp ; WHICH STORES THE OCTAL EQUIVALENT 

; OF THE EXPRESSION exp IN THE NEXT 
; BYTE . 

.BYTE expl ,exp2 , . . . ; WHICH STORES THE OCTAL EQUIVALENTS 

; OF THE LIST OF EXPRESSIONS IN 
; SUCCESSIVE BYTES. 

where a legal expression must have an absolute value (or contain a 
reference to an external symbol) and must result in eight bits or less 
of data. The 16-bit value of the expression must have a high-order 
byte (which is truncated) that is either all zeros or all ones. Each 
operand expression is stored in a byte of the object program. 
Multiple operands are separated by commas and stored in successive 
bytes. For example: 


SAM=5 

.=410 

•BYTE +D48 , SAM 


060 (OCTAL EQUIVALENT OF 48 DECIMAL) 
IS STORED IN LOCATION 410, 005 IS 
STORED IN LOCATION 411. 


If the high order byte of 
0 or -1 , it is truncated 
a T error code. 


the expression equates to a value other 
to the low-order eight bits and flagged 


than 

with 
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If an operand following the .BYTE directive is null, it is interpreted 
as a zero. For example: 

.=420 

.BYTE ,, ; ZEROES ARE STORED IN BYTES 420, 

421, AND 422. 


5.3.2 .WORD 

The .WORD directive is used to generate successive words of data. The 
directive is of the form: 


.WORD exp 


WHICH STORES THE OCTAL EQUIVALENT 
OF THE EXPRESSION exp IN THE NEXT 
WORD 


.WORD expl , exp2 , . . . 


WHICH STORES THE OCTAL EQUIVALENTS 
OF THE LIST OF EXPRESSIONS IN 
SUCCESSIVE WORDS. 


where a legal expression must result in sixteen bits or less of data. 
Each operand expression is stored in a word of the object program. 
Multiple operands are separated by commas and stored in successive 
words. For example: 

SAL=0 

.=500 

.WORD 177535, .+4, SAL jSTORES 177535, 506, AND 0 IN 

, -WORDS 500, 502, AND 504. 

If an expression equates to a value of more than sixteen bits, it is 
truncated and flagged with a T error code. 

If an operand following the .WORD directive is null, it is interpreted 
as zero. For example: 


.=500 

Word ,5, ; STORES 0, 5, AND 0 IN LOCATIONS 500 

; 5 0 2 , AND 504. 

A blank operator field (any operator not recognized as a macro call, 
op-code, directive or semicolon) is interpreted as an implicit .WORD 
directive. Use of this convention is discouraged. The first term of 
the first expression in the operand field must not be an instruction 
mnemonic or assembler directive unless preceded by a + or - operator. 
For example: 


.=440 

LABEL: +MOV, LABEL 


THE OP-CODE FOR MOV, WHICH IS 010000, 
IS STORED ON LOCATION 440. 

440 IS STORED IN LOCATION 442. 


Note that the default .WORD directive occurs whenever there is a 
leading arithmetic or logical operator, or whenever a leading symbol 
is encountered which is not recognized as a macro call, an instruction 
mnemonic or assembler directive. Therefore, if an instruction 
mnemonic, macro call or assembler directive is misspelled, the .WORD 
directive is assumed and errors will result. Assume that MOV is 
spelled incorrectly as MOR: 


MOR A , B 
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Two error codes result: Q occurs because an expression operator is 
missing between MOR and A, and a U occurs if MOR is undefined. Two 
words are then generated: one for MOR A and one for B. 


5.3.3 ASCII Conversion of One or Two Characters 

The ' and " characters are used to generate text characters within the 
source text. A single apostrophe followed by a character results in a 
word in which the 7-bit ASCII representation of the character is 
placed in the low-order byte and zero is placed in the high-order 
byte. For example: 

MOV # 1 A , RO 

results in the following sixteen bits being moved into RO : 


15 8 7 0 



octal ASCII value of A 


The ' character is never followed by a carriage return, null, rubout, 
line feed or form feed. (For another use of the ' character, see 
Sect ion 5.3.6.) 

STMNT : 

GETSYM 
BEQ 4$ 

CMPB 0CHRPNT , # ' : ;COLON DELIMITS LABEL FIELD. 

BEQ LABEL 

CMPB 0CHRPNT , # ' = ; EQUAL DELIMITS 

BEQ ASGMT ; ASSIGNMENT PARAMETER. 

A double quote followed by two characters results in a word in which 
the 7-bit ASCII representations of the two characters are placed. For 
example : 

MOV # " AB , RO 

results in the following word being moved into RO: 



octal ASCII value of B octal ASCII value of A 
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The " character is never followed by a carriage return, null, rubout, 
line feed or form feed. For example: 

; DEVICE NAME TABLE 

DEVNAM: .WORD "DF 

.WORD "DK 

.WORD "DP 

DEVNKB : .WORD "KB 

.WORD "DT 

.WORD "LP 

.WORD "PR 

.WORD "PP 

•WORD "CR 

. WORD " MT 

. WORD 0 


5.3.4 .ASCII 

The .ASCII directive translates character strings into their 7-bit 

.ASCII equivalents for use in the source program. The format of the 

.ASCII directive is as follows: 

.ASCII /character string/ 

where : 

character is a string of any acceptable printing ASCII 

string characters. The string may not include null 

(blank) characters, rubout, carriage return, 
line feed, vertical tab, or form feed. 

Nonprinting characters can be expressed in 
digits of the current radix and delimited by 
angle brackets. (Any legal, defined 
expression is allowed between angle 

brackets . ) 

/ / these are delimiting characters and may be 

any printing characters other than ; , <, 
and = characters and any character within the 
str ing . 

As an example: 

A: .ASCII /HELLO/ ; STORES ASCII REPRESENTATION OF THE 

; LETTERS H,E,L,L,0 IN CONSECUTIVE 
; BYTES . 

• ASCII ABC/<15X12>/DEF/ ;STORES A , B , C , 1 5 , 12 , D , E , F IN 

; CONSECUTIVE BYTES. 

.ASCII / <AB>/ ; STORES <,A,B,> IN CONSECUTIVE 

; BYTES . 

The ; and = characters are not illegal delimiting characters, but are 

pre-empted by their significance as a comment indicator and assignment 


RF DISK 

RK DISK 

RP DISK 

TTY KEYBOARD 

DECTAPE 

LINE PRINTER 

PAPER TAPE READER 

PAPER TAPE PUNCH 

CARD READER 

MAGTAPE 

TABLE'S END 
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operator, respectively. For other than the first group, semicolons 
are treated as beginning a comment field. For example: 

ASCII string 

Example Generated Notes 


.ASCII 

; ABC ;/DEF/ 

A 

B 

C D E F 

Acceptable, but not a recommended 
procedure . 

.ASCII 

/ABC/ ; DEF ; 

A 

B 

C 

; DEF ; is treated as a comment and 
ignored . 

.ASCII 

/ABC/ =DEF= 

A 

B 

C D E F 

Acceptable, but not recommended 
procedure . 

.ASCII 

= DEF = 




The assignment 


. ASCII=DEF 


is performed and a Q-error is 
generated upon encountering the 
second =. 


5.3.5 . ASC I Z 

The . ASC I Z directive is equivalent to the .ASCII directive with a zero 
byte automatically inserted as the final character of the string. For 
example : 

When a list or text string has been created with a .ASCIZ 
directive, a search for the null character can determine the end 
of the list. For example: 


MOV #HELLO , Rl 
MOV #LINBUF,R2 
X: MOVB (R1)+,(R2)+ 

BNE X 


HELLO: .ASCIZ <15><12>/MAC11 V1A/<15><12> ; INTRO MESSAGE 


5.3.6 . RAD 50 

The .RAD50 directive allows the user the capability to handle symbols 
in Radix-50 coded form (this form is sometimes referred to as MOD40) . 
Radix-50 form allows three characters to be packed into sixteen bits; 
therefore, any 6-character symbol can be held in two words. The form 
of the directive is: 

. RAD50 /string/ 
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where : 


/ / delimiters can be any printing characters 

other than the =, <, and ; characters. 

string is a list of the characters to be converted 

(three characters per word) and which may 
consist of the characters A through Z, 0 
through 9, dollar ($), dot (.) and space ( ). 
If there are fewer than three characters (or 
if the last set is fewer than three 
characters) they are considered to be 
left-justified and trailing spaces are 
assumed. Illegal nonprinting characters are 
replaced with a ? character and cause an I 
error flag to be set. Illegal printing 
characters set the 0 error flag. 


The trailing delimiter may be a carriage return, semicolon, or 
matching delimiter. For example: 


. RAD 50 /ABC 

. RAD 50 /AB/ 

. RAD 5 0 // 

. RAD 50 / ABCD/ 


PACK ABC INTO ONE WORD. 

PACK AB (SPACE) INTO ONE WORD. 
PACK 3 SPACES INTO ONE WORD. 
PACK ABC INTO FIRST WORD AND 
D SPACE SPACE INTO SECOND WORD. 


Each character is translated into its Radix-50 equivalent as indicated 
in the following table: 

Character Radix-50 Equivalent (octal) 


( space) 
A-z 
$ 

0-9 


0 

1-32 

33 

34 

36-47 


Note that another character could be defined for code 35, which is 
currently unused. 

The Radix-50 equivalents for characters 1 through 3 (Cl, C2, C 3 ) are 
combined as follows: 


Radix 50 value = ( (Cl*50) +C2) *50+C3 
For example: 

Radix-50 value of ABC is ( (1*50) +2) *50+3 or 3223 

See Appendix A for a table to quickly determine Radix-50 equivalents. 

Use of angle brackets is encouraged in the .ASCII, .ASCIZ, and .RAD50 
statements whenever leaving the text string to insert special codes. 
For example: 

.ASCII <101> ; EQUIVALENT TO .ASCII/A/ 


. RAD 50 /AB/< 35> 


; STORES 3255 IN NEXT WORD 
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CHR1=1 

CHR2=2 

CHR3=3 


. RAD50 <CHR1> <CHR2> <CHR3 > 


; EQUIVALENT TO . RAD50/ABC/ 


5.4 RADIX CONTROL 


5.4.1 .RADIX 

Numbers used in a MACH source program are initially considered to be 
octal numbers. However, the programmer has the option of declaring 
the following radices: 

2, 4, 8, 10 

This is done via the .RADIX directive, of the form: 

.RADIX n 

where : 

n is one of the acceptable radices. 

The argument to the .RADIX directive is always interpreted in decimal 
radix. Following any radix directive, that radix is the assumed base 
for any number specified until the following .RADIX directive. 

The default radix at the start of each program, and the argument 
assumed if none is specified, is 8 (octal). For example: 

.RADIX 10 , -BEGINS SECTION OF CODE WITH DECIMAL RADIX 


.RADIX ,- REVERTS TO OCTAL RADIX 

In general, it is recommended that macro definitions not contain nor 
rely on radix settings from the .RADIX directive. The temporary radix 
control characters should be used within a macro definition. (+D, +0, 
and +B are described in the following Section.) A given radix is valid 
throughout a program until changed. Where a possible conflict exists 
within a macro definition or in possible future uses of that code 
module, it is suggested that the user specify values using the 
temporary radix controls. 


5.4.2 Temporary Radix Control: +D, +0, and +B 


Once the user has specified a radix 
determined to use the default octal 
cases where an alternate radix is mo 
macro definitions). For example, 
best be done in the binary radix. 


for a sec 
radix, he. 
re conveni 
the creat 


t ion 

of c 

may 

d iscove 

en t 

(par tic 

ion 

of a ma 


od 

r 

ul 

sk 


e , or 
a numbe 
arly wi 
word m 


has 
r of 
thin 
ight 
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MAC 1 1 has three unary operators to provide a single interpretation in 
a given radix within another radix as follows: 

t Dx (x is treated as being 

tOx (x is treated as being 

IBx (x is treated as being 

For example: 

+ D123 
to 47 

tB 00001101 
tO<A+3> 

Notice that while the up arrow and radix specification characters may 
not be separated, the radix operator can be physically separated from 
the number by spaces or tabs for formatting purposes. Where a term or 
expression is to be interpreted in another radix, it should be 
enclosed in angle brackets. 

These numeric quantities may be used any place where a numeric value 
is legal. 

PAL-1 1R contains a feature, which is maintained for compatibility in 
MAC 1 1 , allowing a temporary radix change from octal to decimal by 
specifying a decimal radix number with a "decimal point". For 
example : 

100. (144(8)) 

1376. (2540(8)) 

128. (200(8)) 


in decimal radix) 
in octal radix) 
in binary radix) 


5.5 LOCATION COUNTER CONTROL 

The four directives which control movement of the location counter are 
•EVEN and .ODD which move the counter a maximum of one byte, and .BLKB 
and . BLKW which allow the user to specify blocks of a given number of 
bytes or words to be skipped in the assembly. 


5.5.1 .EVEN 

The .EVEN directive ensures that the assembly location counter 
contains an even memory address by adding one if the current address 
is odd. If the assembly location counter is even, no action is taken. 
Any operands following a .EVEN directive are ignored. 

The .EVEN directive is used as follows: 

. ASC I Z /THIS IS A TEST/ 

.EVEN ; ASSURES NEXT STATEMENT 

; BEGINS ON A WORD BOUNDARY. 


.WORD XYZ 
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5.5.2 .ODD 

The .ODD directive ensures that the assembly location counter is odd 
by adding one if it is even. For example: 


; CODE TO MOVE DATA FROM AN INPUT LINE 
; TO A BUFFER 

N=5 ; BUFFER HAS 5 WORDS 


.ODD 

.BYTE N* 2 
BUFF: . BLKW N 


; COUNT = 2N BYTES 
; RESERVE BUFFER OF N WORDS 


MOV 

MOV 

MOVB 

AGAIN: MOVB 

BEQ 
DEC 
BNE 


#BUFF , R2 
#LINE , R1 
1 (R2) , RO 
(Rl)+, (R2)+ 
DONE 
RO 

AGAIN 


; ADDRESS OF EMPTY BUFFER IN R2 
; ADDRESS OF INPUT LINE IS IN R1 
; GET COUNT STORED IN BUFF-1 IN RO 
; MOVE BYTE FROM LINE INTO BUFFER 
; WAS NULL CHARACTER SEEN? 

; DECREMENT COUNT 
; NOT = 0, GET NEXT CHARACTER 


CLRB - ( R2 ) 

DONE: 


; OUT OF ROOM IN BUFFER, CLEAR LAST 
; WORD 


LINE: . ASCI Z /TEXT/ 

In this case, .ODD is used to place the buffer byte count in the byte 
preceding the buffer, as follows: 

COUNT BUFF-2 

BUFF 


5.5.3 . BLKB and .BLKW 

Blocks of storage can be reserved using the .BLKB and .BLKW 
directives. .BLKB is used to reserve byte blocks and .BLKW reserves 
word blocks. The two directives are of the form: 


BLKB 

exp 

BLKW 

exp 
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where : 

exp is the number of bytes or words to reserve. If no 
argument is present, 1 is the assumed default value. 
Any legal expression which is completely defined at 
assembly time and produces an absolute number is legal. 

For example: 


1 000000 
2 

PASS: 

. BLKW 


; NEXT GROUP MUST STAY TOGETHER 

3 000002 

SYMBOL 

. BLKW 

2 

; SYMBOL ACCUMULATOR 

4 000006 

MODE: 




5 000006 

FLAGS: 

.BLKB 

1 

; FLAG BITS 

6 000007 

SECTOR 

.BLKB 

1 

; SYMBOL/EXPRESSIONS TYPE 

7 000010 

VALUE : 

.BLKW 

1 

; EXPRESSION VALUE 

8 00012 

RELLVL 

.BLKW 

1 


9 

10 

11 00020 


.BLKW 

2 

; END OF GROUPED DATA 

CLCNAM 

. BLKW 

2 

; CURRENT LOCATION COUNTER SYMBOL 

12 00024 

CLCFGS 

.BLKB 

1 


13 00025 

CLCSEC 

. BLKB 

1 


14 00026 

CLCLOC 

.BLKW 

1 


15 00030 

CLCMAX 

.BLKW 

1 



The .BLKB directive has the same effect as 
. = . +exp 

but is easier to interpret in the context of source code. 


5.6 TERMINATING DIRECTIVES 


5.6.1 .END 


The .END directive indicates the physical end of the source program. 
The .END directive is of the form: 

.END exp 


where : 


exp is an optional argument which, if present, indicates 
the program entry point, i.e., the transfer address. 

At the conclusion of the first assembly pass, upon encountering the 
END statement, MACH prints: 

END OF PASS 1 

and attempts to reread the source file(s) to perform pass 2. If the 

source file is on a disk, DECtape, or magtape device no further 
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operator action is necessary. If the source file is on paper tape an 
IOPS 4 message is printed; the user is expected to reposition the 
tape in the reader and type tR (for CONTINUE). 


5.7 CONDITIONAL ASSEMBLY DIRECTIVES 


Conditional assembly directives provide the programmer with the 
capability to conditionally include or ignore blocks of source code in 
the assembly process. This technique is used extensively to allow 
several variations of a program to be generated from the source 
program. 

The general form of a conditional block is as follows: 


.IF cond , argument ( s) 


START CONDITIONAL BLOCK 
RANGE OF CONDITIONAL 
BLOCK 


. ENDC 

where : 


; END CONDITIONAL BLOCK 


cond is a condition which must be met if the block 

is to be included in the assembly. These 
conditions are defined below. 


argument(s) are a function of the condition to be tested. 

range is the body of code which is included in the 

assembly or ignored depending upon whether 
the condition was met. 

The following are the allowable conditions: 
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Conditions 


POSITIVE 

COMPLEMENT 

ARGUMENTS 

ASSEMBLE BLOCK IF 

EQ 

NE 

expression 

expressions (or S) 

GT 

LE 

expression 

expression>0 (or <0) 

LT 

GE 

expression 

expressions (or >0) 

DF 

NDF 

symbolic argument 

symbol is defined (or 
undefined) 

B 

NB 

macro-type argument 

argument is a blank (or 
not blank) 

IDN 

DIF 

two macro-type 
arguments separated 
by a comma 

arguments identical 
(or different) 

Z 

NZ 

expression 

same as EQ/NE 

G 

L 

expression 

same as GT/LE 


NOTE 

A macro-type argument is enclosed in 
angle brackets or within an up-arrow 
construction (as described in Section 
6.3). For example : 

<A,B,C> 

V124/ 

For example: 

.IF EQ ALPHA+1 ; ASSEMBLE IF ALPHA+1=0 

. ENDC 

Within the conditions DF and NDF the following two operators are 
allowed to group symbolic arguments: 

& logical AND operator 
! logical inclusive OR operator 

For example: 

•IF DF SYM1 & SYM2 


. ENDC 

assembles if both SYMl and SYM2 are defined. 
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5.7.1 Subconditionals 

Subconditionals may be placed within conditional blocks to indicate: 

1. assembly of an alternate body of code when the condition of 
the block indicates that the code within the block is not to 
be assembled. 

2. assembly of a non-contiguous body of code within the 

conditional block depending upon the result of the 

conditional test to enter the block. 

3. unconditional assembly of a body of code within a conditional 
block . 

There are three subconditional directives, as follows: 


Subconditional 

Function 

. IFF 

The code following this statement up to the next 
subconditional or end of the conditional block is 
included in the program providing the value of the 
condition tested upon entering the conditional 
block was false. 

. IFT 

The code following this statement up to the next 
subconditional or end of the conditional block is 
included in the program providing the value of the 
condition tested upon entering the conditional 
block was true. 

. IFTF 

The code following this statement up to the next 
subconditional or the end of the conditional block 
is included in the program regardless of the value 
of the condition tested upon entering the 
conditional block. 


The implied argument of the subconditionals is the value of the 
condition upon entering the conditional block. Subconditionals are 
used within outer level conditional blocks. Subconditionals are 
ignored within nested, unsatisfied condition blocks. For example: 


.IF DF SYM 

; ASSEMBLE BLOCK IF SYM 

IS DEFINED 


. IFF 

; ASSEMBLE THE FOLLOWING 
; SYM IS UNDEFINED. 

CODE 

ONLY 

IF 

. IFT 

; ASSEMBLE THE FOLLOWING 

CODE 

ONLY 

IF 

• 

; SYM IS DEFINED. 




. IFTF 

; ASSEMBLE THE FOLLOWING 

CODE 



• 

; UNCONDITIONALLY . 




. ENDC 






5-20 





GENERAL ASSEMBLER DIRECTIVES 


.IF DF X 

; ASSEMBLY TESTS FALSE 

.IF DF y 

; TESTS FALSE 

. IFF 

;NESTED CONDITIONAL 

• 

; IGNORED 

. IFT 

; NOT SEEN 

. ENDC 



However , 


. IF DF 

X 

; TESTS TRUE 

. IF DF 

Y 

; TESTS FALSE 

. IFF 


; IS ASSEMBLED 

. IFT 


; NOT ASSEMBLED 

. ENDC 




5.7.2 Immediate Conditionals 

An immediate conditional directive is a means of writing a 1-line 
conditional block. In this form, no .ENDC statement is required and 
the condition is completely expressed on the line containing the 
conditional directive. Immediate conditions are of the form: 

.IIF cond , arg , statement 

where : 

cond is one of the legal conditions defined for 

conditional blocks in Section 5.7. 

arg is the argument associated with the condition 

specified; that is, either an expression, 
symbol, or macro-type argument, as described 
in Section 5.7. 

statement is the statement to be executed if the 

condition is met. 

For example: 

•IIF DF FOO , BEQ ALPHA 
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this statement generates the code 
BEQ ALPHA 

if the symbol FOO is defined. 

A label must not be placed in the label field of the .IIF statement. 
Any necessary labels may be placed on the previous line: 

LABEL: 

.IIF DF FPP, BEQ, ALPHA 
or included as part of the conditional statement: 

•IIF DF FOO, LABEL: BEQ ALPHA 


5.7.3 PAL-1 1R Conditional Assembly Directives 

In order to maintain compatibility with programs developed under 
PAL-1 1R , the following conditionals remain permissible under MACH. 
It is advisable that further programs be developed using the format 
for MAC 1 1 conditional assembly directives. 


Directive 

Arguments 

Assemble Block if 

. IFZ or . IFEQ 
. IFNZ or . IFNE 
. IFL or . IFLT 
. IFG or . IFGT 
. IFLE 
. IFGE 
. IFDF 
. IFNDF 

expression 
expression 
expression 
expression 
expression 
expression 
logical expression 
logical expression 

expr ession=0 
expr ession=0 
expression<0 
expression>0 
expression< or =0 
expression> or =0 
expression is true (defined) 
expression is false 
(undefined) 


The rules governing the usage of these directives are now the same as 
for the MAC 1 1 conditional assembly directives previously described. 
Conditional assembly blocks must end with the . ENDC directive and are 
limited to a nesting depth of 16(10) levels (instead of the 127(10) 
levels allowed under PAL-11R) . 
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MACRO DIRECTIVES 


6.1 MACRO DEFINITION 

It is often convenient in assembly language programming to generate a 
recurring coding sequence with a single statement. In order to do 
this, the desired coding sequence is first defined with dummy 
arguments as a macro. Once a macro has been defined, a single 
statement calling the macro by name with a list of real arguments 
(replacing the corresponding dummy arguments in the definition) 
generates the correct sequence or expansion. 


6.1.1 .MACRO 

The first statement of a macro definition must be a .MACRO directive. 
The .MACRO directive is of the form: 

.MACRO name, dummy argument list 

where : 

name is the name of the macro. This name is any legal 

symbol. The name chosen may be used as a label 
elsewhere in the program. 

represents any legal separator (generally, a comma 
or space) . 

zero, one, or more legal symbols which may appear 
anywhere in the body of the macro definition, even 
as a label. These symbols can be used elsewhere 
in the user program with no conflicts of 
definition. Where more than one dummy argument is 
used, they are separated by any legal separator 
(generally a comma) . 

A comment may follow the dummy argument list in a statement containing 
a .MACRO directive. For example: 

•MACRO ABS A , B ; DEFINE MACRO ABS WITH TWO ARGUMENTS 

A label must not appear on a .MACRO statement. Labels are sometimes 
used on macro calls, but serve no function when attached to .MACRO 
statements . 


dummy 

argument 

list 
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6.1.2 . ENDM 

The final statement of every macro definition must be an .ENDM 
directive of the form: 

.ENDM name 

where : 

name is an optional argument, being the name of the macro 
terminated by the statement. 

For example: 

.ENDM (terminates the current macro definition) 

.ENDM ABS (terminates the definition of the macro ABS) 

If specified, the symbolic name in the .ENDM statement must correspond 
to that in the matching .MACRO statement. Otherwise, the statement is 
flagged and processing continues. Specification of the macro name in 
the .ENDM statement permits the Assembler to detect missing .ENDM 
statements or improperly nested macro definitions. 

The .ENDM statement may contain a comment field, but must not contain 
a label. 

An example of a macro definition is shown below: 

.MACRO TYPMSG MESSGE ; TYPE A MESSAGE 
JSR R5, TYPMSG 
.WORD MESSGE 
. ENDM 


6.1.3 .MEXIT 


In order to implement 
nested macros) , the 
the current macro as 
of .MEXIT bypasses 
alternate paths. For 


alternate exit points from a macro (particularly 
.MEXIT directive is provided. .MEXIT terminates 
though an .ENDM directive were encountered. Use 
the complications of conditional nesting and 
example : 


.MACRO ALTR N,A,B 


. IF 


EQ , N 


; START CONDITIONAL BLOCK 


.MEXIT 
. ENDC 


; EXIT FROM MACRO DURING CONDITIONAL BLOCK 
; END CONDITIONAL BLOCK 


.ENDM ;NORMAL END OF MACRO 

In an assembly where N=0, the .MEXIT directive terminates the macro 
expansion . 
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Where macros are nested, a .MEXIT causes an exit to the next higher 
level. A .MEXIT encountered outside a macro definition is flagged as 
an error . 


6.1.4 MACRO Definition Formatting 

A form feed character used as a line terminator on a MACH source 
statement (or as the only character on a line) causes a page eject. 
Used within a macro definition, a form feed character causes a page 
eject. A page eject is not performed when the macro is invoked. 

Used within a macro definition, the .PAGE directive is ignored, but a 
page eject is performed at invocation of that macro. 


6.2 MACRO CALLS 

A macro must be defined prior to its first reference. Macro calls are 
of the general form: 

label: name, real arguments 


where : 


label 

name 


real 

arguments 


represents an optional statement label. 

represents the name of the macro specified in 
the .MACRO directive preceding the macro 
definition . 

are those symbols, expressions, and values 
which replace the dummy arguments in the 
.MACRO statement. Where more than one 
argument is used, they are separated by any 
legal separator. 


Where a macro name is the same as a user label, the appearance of the 
symbol in the operation field designates a macro call, and the 
occurrence of the symbol in the operand field designates a label 
reference. For example: 


ABS: MOV 0RO,R1 ;ABS IS USED AS A LABEL 


BR ABS 


; ABS IS CONSIDERED A LABEL 


ABS # 4 , ENT , LAR ; CALL MACRO ABS WITH 3 ARGUMENTS 

Arguments to the macro call are treated as character strings whose 
usage is determined by the macro definition. 
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6.3 ARGUMENTS TO MACRO CALLS AND DEFINITIONS 

Arguments within a macro definition or macro call are separated from 
other arguments by any of the separating characters described in 
Section 3.1.1. For example: 

.MACRO REN A , B , C 


REN ALPHA, BETA, <C1,C2> 

Arguments which contain separating characters are enclosed in paired 
angle brackets. An up-arrow construction is provided to allow angle 
brackets to be passed as arguments. Bracketed arguments are seldom 
used in a macro definition, but are more likely in a macro call. For 
example : 

REN <MOV X,Y>#44,WEV 

This call would cause the entire statement: 

MOV X , Y 

to replace all occurrences of the symbol A in the macro definition. 
Real arguments within a macro call are considered to be character 
strings and are treated as a single entity until their use in the 
macro expansion. 

The up-arrow construction could have been used in the above macro call 
as follows: 

REN t/MOV X , Y/ , #4 4 , WEV 
which is equivalent to 

REN <MOV X,Y> , #44 ,WEV 

Since spaces are ignored preceding an argument, they can be used to 
increase legibility of bracketed constructions. The form: 

REN #44, WEV +/MOV X , Y/ 

however, contains only two arguments: #44 and WEV +/MOV X,Y/ (see 

Section 3.1.1) because t is a unary operator. 


6.3.1 Macro Nesting 

Macro nesting (nested macro calls) , where the expansion of one macro 
includes a call to another macro, causes one set of angle brackets to 
be removed from an argument with each nesting level. The depth of 
nesting allowed is dependent upon the amount of core space used by the 
program. To pass an argument containing legal argument delimiters to 
nested macros, the argument should be enclosed in one set of angle 
brackets for each level of nesting, as shown below. 

.MACRO LEVEL1 DUM1,DUM2 
LEVEL2 DUM1 
LEVEL2 DUM2 
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. ENDM 

.MACRO LEVEL2 DUM3 
DUM3 

ADD #10, RO 
MOV RO, (Rl) + 

.ENDM 

A call to the LEVEL1 macro: 

LEVEL1 <<MOV X , RO > > , < <CLR R0>> 

causes the following expansion: 

MOV X , RO 
ADD #10, RO 
MOV RO, (Rl) + 

CLR RO 
ADD #10, RO 
MOV RO, (Rl) + 

where macro definitions are nested (that is, a macro definition is 
entirely contained within the definition of another macro) the inner 
definition is not defined as a callable macro until the outer macro 
has been called and expanded. For example: 

.MACRO LV1 A , B 


.MACRO LV2 A 


.ENDM 

.ENDM 

The LV2 macro cannot be called by name until after the first call to 
the LVl macro. Likewise, any macro defined within the LV2 macro 
definition cannot be referenced directly until LV2 has been called. 


6.3.2 Special Characters 

Arguments may include special characters without enclosing the 
argument in a bracket construction if that argument does not contain 
spaces, tabs, semi-colons, or commas. For example: 

.MACRO PUSH ARG 
MOV ARG , - (SP) 

. ENDM 


PUSH X+3 ( % 2 ) 

generates the following code: 
MOV X + 3 ( % 2 ) , - (SP) 
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6.3.3 Numeric Arguments Passed as Symbols 

When passing macro arguments, a useful capability is to pass a symbol 
which can be treated by the macro as a numeric string. An argument 
preceded by the unary operator backslash (\) is treated as a number in 
the current radix. The ASCII characters representing the number are 
inserted in the macro expansion; their functions are defined in 
context. For example: 

B=0 

•MACRO INC A , B 
CNT A , \B 
B=B + 1 
. ENDM 

.MACRO CNT A , B 

A ' B : .WORD ;SEE SEC. 6. 3. 6 FOR EXPLANATION OF 'B. 

.ENDM 


INC X,C 

The macro call would expand to: 

XO: .WORD 

A subsequent identical call to the same macro would generate: 

XI: .WORD 

and so on for later calls. The two macros are necessary because the 
dummy value of B cannot be updated in the CNT macro. In the CNT 
macro, the number passed is treated as a string argument. (Where the 
value of the real argument is 0, a single 0 character is passed to the 
macro expansion.) 

The number being passed can also be used to make source listings 
somewhat clearer. For example, versions of programs created through 
conditional assembly of a single source can identify themselves as 
follows : 


.MACRO IDT SYM 
•ASCII /SYM/ 
.ENDM 

•MACRO OUT ARG 
IDT 005A 'ARG 
. ENDM 


ASSUME THAT THE SYMBOL ID TAKES 
ON A UNIQUE TWO DIGIT VALUE FOR 
EACH POSSIBLE CONDITIONAL ASSEMBLY 
OF THE PROGRAM 


OUT \ID 

The above macro call expands to: 
.ASCII /005AXX/ 


WHERE 005A IS THE UPDATE 
VERSION OF THE PROGRAM 
AND ARG INDICATES THE 
CONDITIONAL ASSEMBLY VERSION. 


where XX is the conditional value of ID. 


Two macros are necessary since the text delimiting characters in the 
.ASCII statement would inhibit the concatenation of a dummy argument. 
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6.3.4 Number of Arguments 

If more arguments appear in the macro call than in the macro 
definition, the excess arguments are ignored. If fewer arguments 
appear in the macro call than in the definition, missing arguments are 
assumed to be null (consist of no characters) . The conditional 
directives .IFB and . IFNB can be used within the macro to detect 
unnecessary arguments. 

A macro can be defined with no arguments. 


6.3.5 Automatically Created Symbols 


MAC 11 can be made to create symbols of the 
decimal integer number such that 64<n<127. 
local symbols between 64$ and 127$. (For 
symbols, see Section 3.5.) Such local 
Assembler in numerical order; i.e.: 


form n$ where n 
Created symbols are 
a description of 
symbols are created 


is a 
always 
local 
by the 


64$ 

65$ 


126$ 

127$ 

Created symbols are particularly useful where a label is required in 
the expanded macro. Such a label must otherwise be explicitly stated 
as an argument with each macro call or the same label is generated 
with each expansion (resulting in a multiply-defined label). Unless a 
label is referenced from outside the macro, there is no reason for the 
programmer to be concerned with that label. 

The range of these local symbols extends between two explicit labels. 
Each new explicit label causes a new local symbol block to be 
initialized . 

The macro processor creates a local symbol on each call of a macro 
whose definition contains a dummy argument preceded by 
the ? character. For example; 

.MACRO ALPHA A,?B 
TST A 

BEQ B 

ADD #5, A 
B: 

. ENDM 

Local symbols are generated only where the real argument of the macro 
call is either null or missing. If a real argument is specified in 
the macro call, the generation of a local symbol is inhibited and 
normal replacement is performed. Consider the following expansions of 
the macro ALPHA above. 
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GENERATE A LOCAL SYMBOL FOR MISSING ARGUMENT: 


ALPHA %1 
TST %1 
BEQ 64$ 

ADD #5 , %1 

64$ : 


DO NOT CREATE A LOCAL SYMBOL: 


ALPHA % 2 , XYZ 
TST %2 
BEQ XYZ 
ADD #5 , %2 

XYZ : 


These Assembler-generated symbols are restricted to the first sixteen 
(decimal) arguments of a macro definition. 


6.3.6 Concatenation 

The apostrophe or single quote character ( ' ) operates as a legal 
separating character in macro definitions. An ' character which 
precedes and/or follows a dummy argument in a macro definition is 
removed and the substitution of the real argument occurs at that 
point. For example: 

.MACRO DEF A,B,C 
A'B: . ASC I Z /C/ 

. WORD ' ' A ' ' ' B 
. ENDM 

When this macro is called: 

DEF X , Y , <MAC11> 

it expands as follows: 

XY: . ASC I Z /MACH/ 

•WORD ' X 1 Y 

In the macro definition, the scan terminates upon finding the 
first ' character. Since A is a dummy argument, the ' is removed. 
The scan resumes with B, notes B as another dummy argument and 
concatenates the two dummy arguments. The third dummy argument is 
noted as going into the operand of the .ASCIZ directive. On the next 
line (this example is purely for illustrative purposes) the argument 
to .WORD is seen as follows: The scan begins with a ' character. 

Since it is neither preceded nor followed by a dummy argument, 
the ' character remains in the macro definition. The scan then 
encounters the second ' character which is followed by a dummy 
argument and is discarded. The scan of the argument A terminated upon 
encountering the second ' which is also discarded since it follows a 
dummy argument. The next ' character is neither preceded nor followed 
by a dummy argument and remains in the macro expansion. The 
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last ' character is followed by another dummy argument and is 
discarded. (Note that the five ' characters were necessary to 
generate two 1 characters in the macro expansion.) 

Within nested macro definitions, multiple single quotes can be used, 
with one quote removed at each level of macro nesting. 


6.4 .NARG, .NCHR, AND . NTYPE 

These three directives allow the user to obtain the number of 
arguments in a macro call (.NARG), the number of characters in an 
argument (.NCHR), or the addressing mode of an argument (.NTYPE). Use 
of these directives permits selective modifications of a macro 
depending upon the nature of the arguments passed. 

The .NARG directive enables the macro being expanded to determine the 
number of arguments supplied in the macro call, and is of the form: 

label: .NARG symbol 

where : 

label is an optional statement label 

symbol is any legal symbol whose value is equated to the 
number of arguments in the macro call currently 
being expanded. The symbol can be used by itself or 
in expressions. 

This directive can occur only within a macro definition. 

The .NCHR directive enables a program to determine the number of 
characters in a character string, and is of the form: 

label: .NCHR symbol, <character string> 

where : 

label is an optional statement label. 

symbol is any legal symbol which is equated to the 

number of characters in the specified character 
string. The symbol is separated from the 
character string argument by any legal 
separator . 

Ccharacter is a string of printing characters which should 
string> only be enclosed in angle brackets if it 

contains a legal separator. A semi-colon also 
terminates the character string. 

This directive can occur anywhere in a MACH program. 

The .NTYPE directive enables the macro being expanded to determine the 
addressing mode of any argument, and is of the form: 

label: .NTYPE symbol, arg 
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where : 

label is an optional statement label. 

symbol is any legal symbol, the low-order 6-bits of which 
are equated to the 6-bit addressing mode of the 
argument. The symbol is separated from the argument 
by a legal separator. This symbol can be used by 
itself or in expressions. 

arg is any legal macro argument (dummy argument) as 

defined in Section 6.3. 

This directive can occur only within a macro definition. An example 
of .NTYPE usage in a macro definition is shown below: 

.MACRO SAVE ARG 

.NTYPE S YM , ARG 

.IF EQ , SYM& 7 0 

MOV ARG, TEMP ; REGISTER MODE 

. IFF 

MOV #ARG , TEMP ; NON-REGISTER MODE 

. ENDC 
. ENDM 


6.5 .ERROR and .PRINT 

The .ERROR directive is used to output messages to the command output 
device during assembly pass 2. A common use is to provide diagnostic 
announcements of a rejected or erroneous macro call. The form of the 
•ERROR directive is as follows: 

label: .ERROR expr;text 

where : 

label is an optional statement label. 

expr is an optional legal expression whose value is 

output to the command device when the .ERROR 
directive is encountered. Where expr is not 
specified, the text only is output to the command 
device . 

; denotes the beginning of the text string to be 

output . 

text is the string to be output to the command device. 

The text string is terminated by a line 
terminator . 

Upon encountering a .ERROR directive anywhere in a MACH program, the 
Assembler outputs a single line containing: 

1. the sequence number of the .ERROR directive line, 

2. the current value of the location counter, 

3. the value of the expression if one is specified, and 

4. the text string specified. 
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For example: 

.ERROR A ; UNACCEPTABLE MACRO ARGUMENT 

causes a line similar to the following to be output: 

512 5642 000076 ; UNACCEPTABLE MACRO ARGUMENT 

This message is being used to indicate an inability of the subject 
macro to cope with the argument A which is detected as being indexed 
deferred addressing mode (mode 70) with the stack pointer (%6) used as 
the index register. 

The line is flagged on the assembly listing with a P error code. 

The .PRINT directive is identical to .ERROR except that it is not 
flagged with a P error code. 


6.6 INDEFINITE REPEAT BLOCK: . IRP AND . IRPC 

An indefinite repeat block is a structure very similar to a macro 
definition. An indefinite repeat is essentially a macro definition 
which has only one dummy argument and is expanded once for every real 
argument supplied. An indefinite repeat block is coded in-line with 
its expansion rather than being referenced by name as a macro is 
referenced. An indefinite repeat block is of the form: 

label: .IRP arg,<real arguments> 


(range of the indefinite repeat) 


where : 


. ENDM 


label 


arg 


Creal argument> 


range 


is an optional statement label. A label may 
not appear on any .IRP statement within 
another macro definition, repeat range or 
indefinite repeat range, or on any .ENDM 
statement . 

is a dummy argument which is successively 
replaced with the real arguments in the .IRP 
statement . 


is a list of arguments to be used in the 
expansion of the indefinite repeat range and 
enclosed in angle brackets. Each real 
argument is a string of zero or more 
characters or a list of real arguments 
(enclosed in angle brackets) . The real 
arguments are separated by commas. 


is the block of code to be repeated once for 
each real argument in the list. The range 
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may contain macro definitions, repeat ranges, 
or other indefinite repeat ranges. Note that 
only created symbols should be used as labels 
within an indefinite repeat range. 

An indefinite repeat block can occur either within or outside macro 
definitions, repeat ranges, or indefinite repeat ranges. The rules 
for creating an indefinite repeat block are the same as for the 
creation of a macro definition (for example, the .MEXIT statement is 
allowed in an indefinite repeat block) . Indefinite repeat arguments 
follow the same rules as macro arguments. 


1 

2 

000000 
000001 
000002 
000003 
000004 
000005 
000006 
000007 
000006 
000007 
177776 
177570 
3 000000 012/00 

000050 


00004 016720 
000032 


00010 016720 
000030 


00014 016720 
000026 


00020 016720 
000024 


00024 016720 
000022 


00030 016720 
000020 

12 

13 


.TITLE 

.LIST 


R0 = % 

00 

Rl = % 

01 

R2 = % 

02 

R3 = % 

03 

R4 = % 

04 

R5=% 

05 

R6 = % 

06 

R7 = % 

07 

SP=% 

06 

PC = % 

07 

PSW= 

0177776 

SWR = 

0177570 


MOV 

. IRP 
MOV 
. ENDM 
MOV 


MOV 


MOV 


MOV 


MOV 


MOV 
. IRPC 


IRPTST 
MD , MC , ME 


#TABLE ,R0 

X,<A,B,C,D,E,F> 
X , (R0) + 

A, (R0) + 

B, (R0) + 

C , (R0) + 

D, (R0) + 

E , (R0) + 

F, (R0) + 

X , ABCDEF 


Figure 6-1 

IRP and IRPC Example 
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14 






15 




.ASCII 

/x/ 

16 






17 




.ENDM 



00034 

101 


.ASCII 

/A/ 


00035 

102 


.ASCII 

/B/ 


00036 

103 


.ASCII 

/c/ 


00037 

104 


.ASCII 

/D/ 


00040 

105 


.ASCII 

/E/ 


00041 

106 


.ASCII 

/F/ 

18 






19 






20 

00042 

041101 

A 

.WORD 

"AB 

21 

00044 

041502 

B 

.WORD 

"BC 

22 

00046 

042103 

C 

. WORD 

"CD 

23 

00050 

042504 

D 

• WORD 

"DE 

24 

00052 

043105 

E 

• WORD 

"EF 

25 

00054 

043506 

F 

.WORD 

"FG 

26 

00056 


TABLE: . BLKW 

6 

27 






28 


000001 


.END 



Figure 6-1 (Cont.) 

. IRP and . IRPC Example 


A second type of indefinite repeat block is available which handles 
character substitution rather than argument substitution. The .IRPC 
directive is used as follows: 

label: .IRPC arg, string 


(range of indefinite repeat) 


. ENDM 

On each iteration of the indefinite repeat range, the dummy argument 
(arg) assumes the value of each successive character in the string. 
Terminators for the string are: space, comma, tab, carriage return, 
line feed, and semi-colon. 


6.7 REPEAT BLOCK: . REPT 


Occasionally it is useful to duplicate a block of code a number of 
times in-line with other source code. This is performed by creating a 
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repeat block of the form: 

label: .REPT expr 


(range of repeat block) 


. ENDM ; OR . ENDR 

where : 

label is an optional statement label. The .ENDR or .ENDM 

directive may not have a label. A .REPT statement 

occurring within another repeat block, indefinite 
repeat block, or macro definition may not have a 
label associated with it. 

expr is any legal expression controlling the number of 

times the block of code is assembled. Where expr<0, 
the range of the repeat block is not assembled. 

range is the block of code to be repeated expr number of 

times. The range may contain macro definitions, 
indefinite repeat ranges, or other repeat ranges. 
Note that no statements within a repeat range can 
have a label. 

The last statement in a repeat block can be an .ENDM or .ENDR 
statement. The .ENDR statement is provided for compatibility with 
previous assemblers. 

The .MEXIT statement is also legal within the range of a repeat block. 
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OPERATING PROCEDURES 


This MAC 11 Assembler assembles one ASCII source file containing MACH 
statements at a time into a single absolute binary output file. The 
output of the Assembler consists of an absolute binary file on a paper 
tape, and an assembly listing followed by the symbol table listing on 
the device assigned to .DAT-12. 


7.1 LOADING MACH 

MACll is loaded under VXM/DOS by typing: 

$MAC11 (followed by a carriage return or altmode) 

(Characters printed by the system are underlined to differentiate them 
from characters printed by the user.) The Assembler responds by 
identifying itself and its version number, followed by a > character 
to indicate readiness to accept a command input string: 

MACll XVM Vnxnnn 

> 


7.2 COMMAND INPUT STRING 

In response to the > printed by the Assembler, the user types the 
switch options followed by the input filename; the switch options and 
the filename are separated by a or underbar. Command input can be 

terminated by a carriage return to restart MACll, or by an altmode to 
return to the monitor at the end of assembly. 

^SW-t-FILNAM 

where : 

SW is the switch option(s); can be null (for an 

assembly with no output,) or 'B 1 (for binary output) 
or 'L' (for listing) or both. 

FILNAM is the input filename from .DAT -11. Default 

extension is 'SRC'. The filename can consist of up 
to six characters followed by a space (s) and not 
more than a 3-character extension (additional 
characters cause the message 'NAME ERROR/TOO LONG' 
to be printed on the command input device) . All of 
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the legal printing characters can be used in any 
order. The first non-space character to be typed 
after the first left-arrow («-) or underbar is 
recognized as the first character of the filename. 
Similarly, the first non-space character after the 
filename (other than carriage return or altmode) is 
recognized as the first character of the extension. 

Examples : 

>+- F ILNAM assembly with no output of a file called 

'filnam SRC'; restart MACH 

><-FILNAM EXT-.^ assembly with no output of a file called 

'FILNAM EXT'; restart MACH. 

>B+-FILNAM EXT (ALT) assemble 'FILNAM EXT' with an absolute binary 

output to paper tape; return control to the 
monitor at the end of the assembly. 

A 

_>L-*- FILNAM EXT (ALT) assemble 'FILNAM EXT' with a listing output 

to .DAT -12; return to the monitor. 

>LB-*-XlY2 E00 assemble 'X1Y2 E00 with an absolute binary 

output to paper tape and a listing output to 
.DAT -12; restart MACll. 

If an error is made in typing the command string, typing the RUBOUT 
key erases the immediately-preceding character. Repeated typing of 
the RUBOUT key erases one character for each RUBOUT up to the 
beginning of the line. Typing CTRL/U erases the entire line. Both 
can only be used if the command has not been terminated by a carriage 
return or altmode. 

A syntactical error detected in the command string causes the 
Assembler to print a ? character. The Assembler then reprints 
the > character and waits for a new command string to be entered. If 
the input file is not found or the name and/or the extension is 
illegal, the message: 

NAME ERROR/TOO LONG 

is printed. 


7.3 PAPER TAPE SOURCES 

If the source file is on disk, DECtape or magtape, no operator 
intervention is necessary at the end of Pass 1. If, however, it is on 
tape, an I0PS4 message will be printed on the console device at the 
end of Pass 1; the operator must reposition the tape in the reader 
and type +R to continue. 
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MACH CHARACTER SETS 


A . 1 ASCII CHARACTER SET 


EVEN 

PARITY 

7-BIT 

OCTAL 



BIT 

CODE 

CHARACTER 

REMARKS 

0 

000 

NUL 

NULL, TAPE FEED, CONTROL/SHIFT/P. 

1 

001 

SOH 

START OF HEADING: ALSO SOM, START 

OF MESSAGE, CONTROL/A. 

1 

002 

STX 

START OF TEXT; ALSO EOA , END OF 
ADDRESS, CONTROL/B. 

0 

003 

ETX 

END OF TEXT; ALSO EOM , END OF 
MESSAGE, CONTROL/C. 

1 

004 

EOT 

END OF TRANSMISSION (END) ; SHUTS 
OFF TWX MACHINES, CONTROL/D. 

0 

005 

ENQ 

ENQUIRY (ENQRY) ; ALSOWRU, 
CONTROL/E. 

0 

006 

ACK 

ACKNOWLEDGE; ALSO RU , CONTROL/F 

1 

007 

BEL 

RINGS THE BELL. CONTROL/G. 

1 

010 

BS 

BACKSPACE; ALSO FEO, FORMAT 
EFFECTOR. BACKSPACES SOME 
MACHINES. CONTROL/H. 

0 

Oil 

HT 

HORIZONTAL TAB. CONTROL/I. 

0 

012 

LF 

LINE FEED OR LINE SPACE (NEW LINE) ; 
ADVANCES PAPER TO NEXT LINE, 
DUPLICATED BY CONTROL/J. 

1 

013 

VT 

VERTICAL TAB ( VTAB) . CONTROL/K . 

0 

014 

FF 

FORM FEED TO TOP OF NEXT PAGE 
(PAGE) . CONTROL/L. 

1 

015 

CR 

CARRIAGE RETURN TO BEGINNING OF 
LINE. DUPLICATED BY CONTROL/M. 

1 

016 

SO 

SHIFT OUT; CHANGES RIBBON COLOR TO 
RED. CONTROL/N. 

0 

017 

SI 

SHIFT IN; CHANGES RIBBON COLOR TO 
BLACK. CONTROL/O . 

1 

020 

DLE 

DATA LINK ESCAPE. CONTROL/B (DC0) . 

0 

021 

DC1 

DEVICE CONTROL 1, TURNS TRANSMITTER 
(READER) ON, CONTROL/Q (X ON) . 

0 

022 

DC2 

DEVICE CONTROL 2, TURNS PUNCH OR 
AUXILIARY ON. CONTROL/R (TAPE, 
AUX ON) . 

1 

023 

DC 3 

DEVICE CONTROL 3, TURNS TRANSMITTER 
(READER) OFF, CONTROL/S (X OFF) . 
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024 


025 

026 
027 


EVEN 7-BIT 

PARITY OCTAL 


BIT 

CODE 

CHARACTER 

REMARKS 

0 

030 

CAN 

CANCEL (CANCL) . 

CONTROL/X. 

1 

031 

EM 

END OF MEDIUM. 

CONTROL/Y. 

1 

032 

SUB 

SUBSTITUTE. CONTROL/Z . 

1 

033 

ESC 

ESCAPE. CONTROL/SHIFT/K. 

1 

034 

FS 

FILE SEPARATOR. 

CONTROL/SHIFT/L. 

0 

035 

GS 

GROUP SEPARATOR. 

CONTROL/SHIFT/M. 

0 

036 

RS 

RECORD SEPARATOR 

CONTROL/SHIFT/N. 

1 

037 

US 

UNIT SEPARATOR. 

CONTROL/SHIFT/O. 

1 

040 

SP 

SPACE. 


0 

041 

i 



0 

042 

II 



1 

043 

# 



0 

044 

$ 



1 

045 

% 



1 

046 

& 



0 

047 

1 

ACCENT ACUTE OR 

APOSTROPHE. 

0 

050 

( 



1 

051 

) 



1 

052 

★ 



0 

053 

+ 



1 

054 

t 



0 

055 

- 



0 

056 




1 

057 

/ 



0 

060 

0 



1 

061 

1 



1 

062 

2 



0 

063 

3 



1 

064 

4 



0 

065 

5 



0 

066 

6 



1 

067 

7 



1 

070 

8 



0 

071 

9 



0 

072 

: 



1 

073 




0 

074 

< 



1 

075 

= 



1 

076 

> 



0 

077 

? 



1 

100 

@ 



0 

101 

A 



0 

102 

B 



1 

103 

C 



0 

104 

D 



1 

105 

E 



1 

106 

F 



0 

107 

G 




0 

1 

1 

0 


DC4 DEVICE CONTROL 4, TURNS PUNCH OR 

AUXILIARY OFF. CONTROL/T (AUX OFF). 
NAK NEGATIVE ACKNOWLEDGE; ALSO ERR, 

ERROR. CONTROL/U. 

SYN SYNCHRONOUS FILE (SYNC) . CONTROL/V. 

ETB END OF TRANSMISSION BLOCK; ALSO 

LEM, LOGICAL END OF MEDIUM. 
CONTROL/W. 
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EVEN 

7-BIT 


PARITY 

OCTAL 


BIT 

CODE 

char; 

0 

110 

H 

1 

111 

I 

1 

112 

J 

0 

113 

K 

1 

114 

L 

0 

115 

M 

0 

116 

N 

1 

117 

O 

0 

120 

P 

1 

121 

Q 

1 

122 

R 

0 

123 

S 

1 

124 

T 

0 

125 

U 

0 

126 

V 

1 

127 

w 

1 

130 

X 

0 

131 

Y 

0 

132 

Z 

1 

133 

[ 

0 

134 

\ 

1 

135 

] 

1 

136 

+ 

0 

137 

+- 

0 

140 

1 

1 

141 

a 

1 

142 

b 

0 

143 

c 

1 

144 

d 

0 

145 

e 

0 

146 

f 

1 

147 

g 

1 

150 

h 

0 

151 

i 

0 

152 

j 

1 

153 

k 

0 

154 

1 

1 

155 

m 

1 

156 

n 

0 

157 

o 

1 

160 

P 

0 

161 

q 

0 

162 

r 

1 

163 

s 

0 

164 

t 

1 

165 

u 

1 

166 

V 

0 

167 

w 

0 

170 

X 

1 

171 

y 

1 

172 

z 

0 

173 


1 

174 


0 

175 


0 

176 


1 

177 

DEL 


REMARKS 


SHIFT/K. 

SHIFT/L. 

SHIFT/M. 


ACCENT GRAVE. 


THIS CODE GENERATED 
THIS CODE GENERATED 
(IF PRESENT) . 
DELETE, RUBOUT. 


BY ALTMODE. 

BY PREFIX KEY 
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A. 2 RADIX-50 CHARACTER SET 



ASCII Octal 

Radix-50 

Character 

Equivalent 

Equivalent 

space 

40 

0 

A-Z 

101 - 132 

1-32 

$ 

44 

33 

• 

56 

34 

unused 


35 

0 = 9 

60 = 71 

36 = 47 


The maximum Radix-50 value is, thus, 

47*50(2) + 47*50 + 47 = 174777 

The following table provides a convenient means of translating between 
the ASCII character set and its Radix-50 equivalents. For example, 
given the ASCII string X2B, the Radix-50 equivalent is (arithmetic 
performed in octal): 

X = 113000 
2 = 002400 
B = 000002 
X2B = 115402 


MACll CHARACTER SETS 


Translation of ASCII Character Set 
to Radix-50 Equivalents 


Single 

or 

First 

Char . 
Char . 

Second 

Character 

Third 

Character 

A 

003100 

A 

000050 

A 

000001 

B 

006200 

B 

000120 

B 

000002 

C 

011300 

C 

000170 

C 

000003 

D 

014400 

D 

000240 

D 

000004 

E 

017500 

E 

000310 

E 

000005 

F 

022600 

F 

000360 

F 

000006 

G 

025700 

G 

000430 

G 

000007 

H 

031000 

H 

000500 

H 

000010 

I 

034100 

I 

000550 

I 

000011 

J 

037200 

J 

000620 

J 

000012 

K 

042300 

K 

000670 

K 

000013 

L 

045400 

L 

000740 

L 

000014 

M 

050500 

M 

001010 

M 

000015 

N 

053600 

N 

001060 

N 

000016 

0 

056700 

0 

001130 

0 

000017 

P 

062000 

P 

001200 

P 

000020 

Q 

065100 

Q 

001250 

Q 

000021 

R 

070200 

R 

001320 

R 

000022 

S 

073300 

S 

001370 

S 

000023 

T 

076400 

T 

001440 

T 

000024 

U 

101500 

U 

001510 

U 

000025 

V 

104600 

V 

001560 

V 

000026 

w 

107700 

W 

001630 

w 

000027 
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Single 

or 

First 

Char . 
Char. 

Character 

Character 

X 

113000 

X 

001700 

X 

000030 

Y 

116100 

Y 

001750 

Y 

000031 

Z 

121200 

Z 

002020 

z 

000032 

$ 

124300 

$ 

002070 

$ 

000033 

. 

127400 

. 

002140 


000034 

unused 

132500 

unused 

002210 

unused 

000035 

0 

135600 

0 

002260 

0 

000036 

1 

140700 

1 

002330 

1 

000037 

2 

144000 

2 

002400 

2 

000040 

3 

147100 

3 

002450 

3 

000041 

4 

152200 

4 

002520 

4 

000042 

5 

155300 

5 

002570 

5 

000043 

6 

160400 

6 

002640 

6 

000044 

7 

163500 

7 

002710 

7 

000045 

8 

166600 

8 

002760 

8 

000046 

9 

171700 

9 

003030 

9 

000047 
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B.l SPECIAL CHARACTERS 


Character 


Function 


form feed 


line feed 


carriage 

return 

vertical 

tab 


% 

tab 

space 


( 

) 

, (comma) 


+ 


* 


Source line terminator 

Source line terminator 

Formatting character 

Source line terminator 

Label terminator 

Direct assignment indicator 

Register term indicator 

Item terminator 
Field terminator 

Item terminator 
Field terminator 

Immediate expression indicator 

Deferred addressing indicator 

Initial register indicator 

Terminal register indicator 

Operand field separator 

Comment field indicator 

Arithmetic addition operator or 
autoincrement indicator 

Arithmetic subtraction operator or 
autodecrement indicator 

Arithmetic multiplication operator 
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Character 

/ 

& 


It 

1 (apostrophe) 


< 

> 

+ 

\ 


Function 

Arithmetic division operator 

Logical AND operator 

Logical OR operator 

Double ASCII character indicator 

Single ASCII line indicator 

Assembly location counter 

Initial argument indicator 

Terminal argument indicator 

Universal unary operator 
Argument indicator 

MACRO numeric argument indicator 


B . 2 ADDRESS MODE SYNTAX 


n is an integer 
register expre 
expression or a 


between 0 and 
ssion, E is 
n expression in 


7 represen 
an express 
the range 


ting 
ion , 
0 to 


a register. R is a 
ER is either a register 

7 . 


Format 

Address 
Mode Name 

Address 
Mode Number 

Meaning 

R 

Register 

On 

Register R contains the 
operand. R is a register 
expression . 

@ R or (ER) 

Deferred 

Register 

In 

Register R contains the 
operand address. 

(ER) + 

Autoincrement 

2n 

The contents of the register 
specified by ER are 
incremented after being used 
as the address of the operand. 

@ (ER)+ 

Deferred 

Autoincrement 

3n 

ER contains the pointer to the 
address of the operand. ER is 
incremented after use. 

- (ER) 

Autodecrement 

4n 

The contents of register ER 
are decremented before being 
used as the address of the 
operand . 

(ER) 

Deferred 

Autodecrement 

5n 

The contents of register ER 
are decremented before being 
used as the pointer to the 
address of the operand. 
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Format 

Address 
Mode Name 

Address 
Mode Number 

Meaning 

E (ER) 

Index 

6n 

E plus the contents of the 
register specified, ER, is the 
address of the operand. 

@E (ER) 

Deferred 

Index 7n 

E added to ER gives the 
pointer to the address of the 
operand . 

#E 

Immediate 

27 

E is the operand. 

@ #E 

Absolute 

37 

E is the address of the 

operand . 

E 

Relative 

67 

E is the address of the 

operand . 

@ E 

Deferred 

Relative 

77 

E is the pointer to the add- 
ress of the operand. 


B . 3 INSTRUCTIONS 

The instructions which follow are grouped according to the operands 
they take and the bit patterns of their op-codes. 

In the instruction-type format specification, the following symbols 
are used: 

OP Instruction mnemonic 

R Register expression 

E Expression 

ER Register expression or expression 0<ER<7 

A General address specification 

In the representation of op-codes, the following symbols are used: 

SS Source operand specified by a 6-bit address mode. 

DD Destination operand specified by a 6-bit address 

mode . 

XX 8-bit offset to a location (branch instructions) . 

R Integer between 0 and 7 representing a general 

register . 

Symbols used in the description of instruction operands are: 

SE Source Effective Address 

DE Destination Effective address 

I I Absolute value of 

( ) Contents of 

-*• Becomes 

The condition codes in the processor status word (PS) are affected by 
the instructions. These condition codes are represented as follows: 

N Negative bit: set if the result is negative 

Z Zero bit: set if the result is zero 
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V overflow bit: set if the operation caused an overflow 

C Carry bit: set if the operation caused a carry. 

In the representation of the instruction's effect on the condition 
codes, the following symbols are used: 

* Conditionally set 

Not affected 

0 Cleared 

1 Set 

To set conditionally means to use the instruction's result to 
determine the state of the code (see the PDP-11 Processor Handbook). 


Logical operations are represented by the following symbols: 

! Inclusive OR 

! Exclusive OR 

& AND 

- (used over a symbol) NOT (i.e., l's complement) 


B.3.1 Double-Operand Instructions 
Instruction type format: Op A, A 


Status Word 
Condition Codes 


Op-Code 

Mnemonic 

Stands for 

Operation 

N 

Z 

V 

c 

01SSDD 

11SSDD 

MOV 

MOVB 

MOVe 

MOVe Byte 

(SE) (DE) 

★ 

* 

0 

- 

02SSDD 

12SSDD 

CMP 

CMPB 

CoMPar e 
CoMPare Byte 

(SE)-(DE) 

★ 

•k 

★ 

* 

03SSDD 

13SSDD 

BIT 

BITB 

Bit Test 
Bit Test Byte 

(SE) & (DE) 

* 

* 

0 

- 

04SSDD 

14SSDD 

BIC 

BICB 

Bit Clear 
Bit Clear Byte 

(SE) & (DE)+DE 

★ 

•k 

0 

- 

05SSDD 

15SSDD 

BIS 

BISB 

Bit Set 
Bit Set Byte 

(SE) ! ( DE ) -*-DE 

* 

* 

0 

- 

06SSDD 

ADD 

ADD 

(SE) + (DE)+DE 

* 

* 

* 

•k 

16SSDD 

SUB 

SUBtr act 

(DE) - (SE) -+ E 

* 

* 

* 

* 


B.3.2 Single-Operand Instructions 
Instruction-type format: Op A 


Op-Code Mnemonic 


Stands for 


Status Word 
Condition Codes 
Operation N Z V C 


0050DD CLR CLear 

1050DD CLRB CLear Byte 


0 DE 


0 10 0 
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Op-Code Mnemonic 


Stands for 


Status Word 
Condition Codes 
Operation N Z V C 


0051DD 

1051DD 

COM 

COMB 

COMplement 
COMplement Byte 

(DE) DE 

0052DD 

1052DD 

INC 

INCB 

INCrement 
INCrement Byte 

( DE ) +1 DE 

0053DD 

1053DD 

DEC 

DECB 

DECr ement 
DECrement Byte 

(DE)-l DE 

0054DD 

1054DD 

NEG 

NEGB 

NEGate 
NEGate Byte 

( DE ) +1 DE 

0055DD 

1055DD 

ADC 

ADCB 

ADd Carry 
ADd Carry Byte 

( DE ) + ( C ) DE 

0056DD 

1056DD 

SBC 

SBCB 

SuBtract Carry 
SuBtract Carry Byte 

(DE)-(C) DE 


**01 


* * * _ 


* * * _ 


* * ★ * 


* * * ★ 


★ * * * 


0057DD TST 
1057DD TSTB 

0060DD ROR 
1060DD RORB 
G061DD ROL 


TeST 

TeST Byte 
Rotate Right 

Rotate Right 
Byte 

Rotate Left 


(DE)-O DE 


p- □— 




even or odd byte 

p d— [L, ...... Hj 


cE 


>] 


★ 


★ 


* 


* 


*00 


* * * 


* * * 


★ ★ * 


1061DD 

ROLB 

Rotate Left 
Byte 

0062DD 

ASR 

Arithmetic 
Shift Right 

1062DD 

ASRB 

Arithmetic 
Shift Right 
Byte 

0063DD 

ASL 

Arithmetic 
Shift Left 

1063DD 

ASLB 

Arithmetic 
Shift Left 
Byte 

0001DD 

JMP 

JuMP 

0003DD 

SWAB 

SWAp Bytes 

0067DD 

SXT 

Sign eXTend 


even or odd byte 

| — □ -H h— | * 



even or odd byte 



* * 


* 


* * 


* 


* * 


* 


* 


* * 


•k 


* * 


DE PC 


**00 

0 DE if N bit - * - - 

clear 

-I DE if N bit 
is set 
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Status Word 
Condition Codes 


Op-Code 

Mnemonic 

Stands for 

Operation 

FN 

FZ 

FV 

FC 

0707DD 

NEGD 

NEGate Double 

- ( FDE ) FDE 

: k 

* 

0 

0 

1704DD 

CLRD 

CLeaR Double 

0 FDE 

0 

1 

0 

0 

1705DD 

TSTD 

TeST Doubel 

(FDE)-O FDE 

* 

* 

0 

0 

1706DD 

ABSD 

make ABSolute 

FDE FDE 

0 

* 

0 

0 

B. 3. 3 

Operate Instructions 






Instruction-Type 

format: Op 






Op-Code 

Mnemonic 

Stands for 

Operation 

N 

Z 

V 

C 

000000 

HALT 

HALT 

The computer stops 
all functions. 

- 

- 

- 

- 

000001 

WAIT 

WAIT 

The computer stops 
and waits for an 
interrupt. 

— 




000002 

RTI 

ReTurn from 
Interrupt 

The PC and PS are 
popped off the SP 

* 

* 

* 

* 


stack : 


( (SP) )->PC 
(SP) +2+SP 
( (SP) )->-PS 
(SP) +2-+SP 


RTI is also used 
to return from a 
trap . 


000005 

RESET 

RESET 

Returns 
devices 
status . 

all I/O 
to power-on 





000241 

CLC 

CLear Carry bit 

0-*C 


- 

- 

- 

0 

000261 

SEC 

SEt Carry bit 

1-C 


- 

- 

- 

1 

000242 

CLV 

CLear overflow bit 

0+V 


- 

- 

0 

- 

000262 

SEV 

SEt overflow bit 

l+V 


- 

- 

1 

- 

000244 

CLZ 

CLear Zero bit 

0+Z 


- 

0 

- 

- 

000264 

SEZ 

SEt Zero bit 

1+Z 


- 

1 

- 

- 

000250 

CLN 

CLear Negative bit 

0-*-N 


0 

- 

- 

- 

000270 

SEN 

SEt Negative bit 

1 + N 


1 

- 

- 

- 
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Status Word 
Condition Codes 


Op-Code 

Mnemonic 

Stands for 

Operation 

N 

z 

V 

c 

000243 

cvc 

Clear overflow and 
Carry bits 

0-*-V 

- 

- 

0 

0 

000254 

CNZ 

Clear Negative and 

0-<-N 

0 

0 

- 

- 



Zero bits 

o-*-z 





000257 

CCC 

Clear all 

0-*-N 

0 

0 

0 

0 



Condition Codes 

o+z 








o>v 








o-*c 





000277 

see 

Set all 

i-*-n 

1 

1 

1 

1 



Condition Codes 

l+Z 








1-+V 








i-»c 






000240 


NOP 


No Operation 


B.3.4 Trap Instructions 

Instruction-type format: Op or Op E where 0 < E < 377(8) 

*OP (only) 


Op-Code Mnemonic 


Stands for 


Status Word 
Condition Codes 


Operation 


000003 BPT 


*000004 IOT 


Breakpoint Trap 


Input/Output Trap 


Trap to location 
14. Reserved for 
system usage. 

Trap to location 
20. This is used 
to call system 
routines. 


104000- 

104377 


EMT 


104400- TRAP 
104777 


EMulator Trap 


TRAP 


Trap to location 
30. Reserved for 
for system usage. 

Trap to location 
34. This is used 
to call any routine 
desired by the 
programmer . 
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B.3.5 Branch Instructions 

Instruction-type format: Op E where -128(10) < (E-.-2)/2 < 127(10) 


Condition to be 
met if branch 


Op-Code 

Mnemonic 

Stands for 

is to 

occur 

0004XX 

BR 

BRanch always 



0010XX 

BNE 

Branch if Not 
Equal (to zero) 

Z = 0 


0014XX 

BEQ 

Branch if EQual 
(to zero) 

Z = 1 


0020XX 

BGE 

Branch if 
Greater than or 
Equal (to zero) 

N ! 

V=0 

0024XX 

BLT 

Branch if Less 
than (zero) 

N I 

V=1 

0030XX 

BGT 

Branch if 
Greater than 
( zero) 

Z ! (N 

! V) =0 

0034XX 

BLE 

Branch if Less 
than or equal 
(to zero) 

Z ! (N 

! V) =1 

1000XX 

BPL 

Branch if PLus 

N=0 


1004XX 

BMI 

Branch if Minus 

N=1 


1010XX 

BHI 

Branch if 
Higher 

C ! 

Z = 0 

1014XX 

BLOS 

Branch if LOwer 
or Same 

C ! 

Z = 1 

1020XX 

BVC 

Branch if 
overflow Clear 

v=o 


1024XX 

BVS 

Branch if 
overflow Set 

V=1 


1030XX 

BCC 

(or BHIS) 

Branch if Carry 
Clear (or 
Branch if 
Higher or Same) 

c=o 


1034XX 

BCS 

(or BLOS) 

Branch if Carry 
Set (or Branch 

C=1 



if Lower 
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B.3.6 Register Destination 
Instruction type format: Op ER , A 


Status Word 
Condition Codes 

Op-Code Mnemonic Stands for Operation N Z V C 


004RDD JSR Jump to SubRoutine Push register on - 

the SP stack, put 
the PC in the 
register . 

DE TEMP (TEMP= 
temporary storage 
register internal 
to processor.) 

( SP) -2 SP 
(REG) (SP) 

(PC) REG 
(TEMP) PC 

The following instruction is available only on the PDP-11/45: 

074RDD XOR exclusive OR (R) ! DE DE * * 0 - 


B.3.7 Subroutine Return 
Instruction type format: Op ER 


Status Word 
Condition Codes 

Op-Code Mnemonic Stands for Operation N Z V C 


00020R RTS ReTurn from Put register in 

Subroutine PC and pop old 

contents from SP 
stack into register 
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B.4 ASSEMBLER 


Form 


~Bn 


~Dn 


~On 


.ASCII string 


.ASCIZ string 


. BLKB exp 


DIRECTIVES 


Operation 


Descr ibed 
in Manual 
Section 


A single-quote character 
(apostrophe) followed by one 
ASCII character generates a 
word containing the 7-bit 
ASCII representation of the 
character in the low-order 
byte and zero in the high 
order byte. 

A double-quote character 
followed by two ASCII 
characters generates a word 
containing the 7-bit ASCII 
representation of the two 
characters . 

Temporary radix control; 
causes the number n to be 
treated as a binary number. 

Temporary radix control; 
causes the number n to be 
treated as a decimal number. 

Temporary radix control; 
causes the number n to be 
treated as an octal number . 

Generates a block of data 
containing the ASCII 
equivalent of the character 
string (enclosed in 
delimiting characters) one 
character per byte. 

Generates a block of data 
containing the ASCII 
equivalent of the character 
string (enclosed in 
delimiting characters) one 
character per byte with a 
zero byte following the 
specified string. 

Reserves a block of storage 
space exp bytes long. 


5.3.3 


5.3.3 


5.4.2 


5.4.2 


5.4.2 


5.3.4 


5.3.5 


5.5.3 
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FORM 

. BLKW exp 

.BYTE expl ,exp2 , . . . 

. DSABL arg 
. ENABL arg 
.END 

•END exp 

. ENDC 
. ENDM 

.ENDM symbol 
.ERROR exp, string 
.EVEN 

.IF cond ,argl ,arg2 , . . 
. IFF 


ASSEMBLY LANGUAGE AND ASSEMBLER 


Descr ibed 
in Manual 

Operation Section 

Reserves a block of storage 5.5.3 

space exp words long. 

Generates successive bytes of 5.3.1 
data containing the octal 
equivalent of the expression ( s) 
specified . 

Disables the assembler 5.2 

function specified by the 
argument . 

Provides the assembler 5.2 

function specified by the 
argument . 

Indicates the physical end 5.6.1 

of source program. An 
optional argument specifies 
the transfer address. 

Indicates the end of a 5.7 

conditional block. 

Indicates the end of the 6.1.2 

current repeat block, 
indefinite repeat block, or 
macro. The optional symbol, 
if used, must be identical to 
the macro name. 

Causes a text string to be 6.5 

output to the command device 
containing the optional 
expression specified and the 
indicated text string. 

Ensures that the assembly 5.5.1 

location counter contains an 
even address by adding 1 if 
it is odd. 

Begins a conditional block of 5.7 
source code which is included 
in the assembly only if the 
stated condition is met 
with respect to the 
argument(s) specified. 

Appears only within a 5.7.1 

conditional block and 

indicates the beginning of a 

section of code to be 

assembled if the condition 

tested false. 
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Descr ibed 
in Manual 

Form 


Operation 

Section 

. IFT 


Appears only within a 
conditional block and 
indicates the beginning of 
a section of code to be 
assembled if the condition 
tested true. 

5.7.1 

. IFTF 


Appears only within a 
conditional block and 
indicates the beginning of 
a section of code to be 
unconditionally assembled. 

5.7.1 

. IIF 

co nd, arg, statement 

Acts as a 1-line conditional 
block where the condition is 

5.7.2 



tested for the argument 
specified. The statement 
is assembled only if the 
condition tests true. 


. IRP 

sym,<argl,arg2, . . .> 

Indicates the beginning of 
an indefinite repeat block 

6 . 6 


in which the symbol specified 
is replaced with successive 
elements of the real argument 
list (which is enclosed in 
angle brackets) . 

. IRPC sym, string Indicates the beginning of an 6.6 

indefinite repeat block in 
which the symbol specified 
takes on the value of 
successive characters in the 
character string. 

Without an argument, .LIST 5.1.1 

increments the listing level 
count by one. With an 
argument .LIST does not alter 
the listing level count but 
formats the assembly listing 
according to the argument 
specified . 

.MACRO sym , ar gl , ar g 2 , . . . Indicates the start of a 6.1.1 

macro named sym containing 
the dummy arguments specified. 

.MEXIT Causes an exit from the 6.1.3 

current macro or indefinite 
repeat block. 

.NARG symbol Appears only within a macro 6.4 

definition and equates the 
specified symbol to the 
number of characters in the 
string (enclosed in 
delimiting characters). 


. LIST 
•LIST arg 
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Described 
in Manual 

Form Operation Section 

. NCHR sym, string Can appear anywhere in a 6.4 

source program; equates the 
symbol specified to the 
number of characters in the 
string (enclosed in 
delimiting characters) . 

Without an argument, .NLIST 5.1.1 

decrements the listing level 
count by 1. With an argument, 

.NLIST deletes the portion of 
the listing indicated by the 
argument . 

. NTYPE sym,arg Appears only in a macro 6.4 

definition and equates the 
low-order six bits of the 
symbol specified to the 
six-bit addressing mode of 
the argument. 

.ODD Ensures that the assembly 5.5.2 

location counter contains an 
odd address by adding 1 if it 
is even. 

.PAGE Causes the assembly listing 5.1.5 

to skip to the top of the 
next page. 

.PRINT exp, string Causes a text string to be 6.5 

output to the command device 
containing the optional 
expression specified and the 
indicated text string. 

.RADIX n Alters the current program 5.4.1 

radix to n, where n can be 2, 

4 , 8 , or 10 . 

.RAD50 string Generates a block of data 5.3.6 

containing the Radix-50 
equivalent of the character 
string (enclosed in 
delimiting characters). 

.REPT exp Begins a repeat block. 6.7 

Causes the section of code 
up to the next .ENDM or 
or .ENDR to be repeated 
exp times. 

. SBTTL string Causes the string to be 5.1.4 

printed as part of the 
assembly listing page header. 

The string part of each .SBTTL 
directive is collected into 


.NLIST 
•NLIST arg 
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Described 
in Manual 
Section 


Form 


.TITLE string 


• WORD expl ,exp2 , . . . 


Operation 

a table of contents at the 
beginning of the assembly 
listing . 

Assigns the first symbolic 5.1.3 

name in the string to the 

object module and causes the 

string to appear on each page 

of the assembly listing. Only 

one .TITLE directive should 

be issued per program. 

Generates successive words 5.3.2 

of data containing the octal 
equivalent of the 
expression ( s) specified. 
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PERMANENT SYMBOL TABLE 


PST 

PERMANENT SYMBOL TABLE 

MACH XVM PAGE 1 

1 

9 


.TITLE 

PST PERMANENT SYMBOL TABLE 

4 

3 

4 

5 

6 


COPYRIGHT 1975 DIGITAL EQUIPMENT CORPORATION 

7 

8 

9 

10 

000020 

DR1= 200 

; DESTRUCTIVE REFERENCE IN FIRST 

11 

000100 

DR2= 100 

; DESTRUCTIVE REFERENCE IN SECOND 

12 




13 




14 




15 

000020 

DFLGEV= 020 

; DIRECTIVE REQUIRES EVEN LOCATION 

16 

000010 

DFLGBM= 010 

; DIRECTIVE USES BYTE MODE 

17 

000004 

DFLCND= 004 

; CONDITIONAL DIRECTIVE 

18 

000002 

DFLMAC= 002 

; MACRO DIRECTIVE 

19 




20 




21 




22 


. I IF DF 

X45, XFLTG= 0 

23 


. I IF DF 

XMACRO, XSMCAL= 0 

24 




25 


.MACRO 

OPCDEF NAME, CLASS, VALUE, FLAGS, COND 

26 


.IF NB 

<COND> 

27 


.IF DF 

COND 

28 


.MEXIT 


29 


. ENDC 


30 


. ENDC 


31 


. RAD 50 

/NAME/ 

32 


.BYTE 

FLAGS+0 

33 


. GLOBL 

OPCL ' CLASS 

34 


.BYTE 

200+OPCL ' CLASS 

35 


.WORD 

VALUE 

36 


. ENDM 


37 




38 


.MACRO 

DIRDEF NAME, FLAGS, COND 

39 


.IF NB 

<COND> 

40 


.IF DF 

COND 

41 


•MEXIT 


42 


.ENDC 


43 


.ENDC 
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PST 

PERMANENT 

SYMBOL 

TABLE 

MACH XVM PAGE 2 




44 



. GLOBL 

NAME 





45 



. RAD 50 

/. 'NAME/ 





4 6 



• BYTE 

FLAGS+0 





47 



.BYTE 

0 





48 



• WORD 

NAME 





49 



. ENDM 






50 









51 

00000 

PSTBAS 


; EASE 





1 

000020 


OPCDEF 

<ADC 

>, 

01, 

005500 , 

DRl 

2 

000030 


OPCDEF 

<ADCB 

>, 

01, 

105500 , 

DR1 

3 

000040 


OPCDEF 

<ADD 

>, 

02, 

060000 , 

DR2 

4 

000110 


OPCDEF 

< ASL 

>, 

01, 

006300, 

DRl 

5 

000120 


OPCDEF 

<ASLB 

>, 

01, 

106300 , 

DRl 

6 

000130 


OPCDEF 

<ASR 

>, 

01, 

006200 , 

DRl 

7 

000140 


OPCDEF 

<ASRB 

>, 

01, 

106200, 

DRl 

8 

000150 


OPCDEF 

<BCC 

>, 

04, 

103000, 


9 

000160 


OPCDEF 

<BCS 

>, 

04, 

103400 , 


10 

000170 


OPCDEF 

<BEQ 

>, 

04, 

001400 , 


11 

000200 


OPCDEF 

<BGE 

>, 

04, 

002000 , 


12 

000210 


OPCDEF 

<BGT 

>, 

04, 

003000, 


13 

000220 


OPCDEF 

< BH I 

>, 

04, 

101000 , 


14 

000230 


OPCDEF 

<BHIS 

>, 

04, 

103000, 


15 

000240 


OPCDEF 

<BIC 

>, 

02, 

040000 , 

DR2 

16 

000250 


OPCDEF 

<BICB 

>, 

02, 

140000 , 

DR2 

17 

000260 


OPCDEF 

<BIS 

>, 

02, 

050000, 

DR2 

18 

000270 


OPCDEF 

<BISB 

>, 

02, 

150000 , 

DR2 

19 

000300 


OPCDEF 

<BIT 

>, 

02, 

030000, 


20 

000310 


OPCDEF 

<BITB 

>, 

02, 

130000, 


21 

000320 


OPCDEF 

<BLE 

>, 

04, 

003400 , 


22 

000330 


OPCDEF 

<BLO 

>, 

04, 

103400 , 


23 

000340 


OPCDEF 

<BLOS 

>, 

04, 

101400 , 


24 

000350 


OPCDEF 

<BLT 

>, 

04, 

002400, 


25 

000360 


OPCDEF 

<BMI 

>, 

04, 

100400 , 


26 

000370 


OPCDEF 

<BNE 

>, 

04, 

001000 , 


27 

000400 


OPCDEF 

< BPL 

>, 

04, 

100000 , 


28 

000420 


OPCDEF 

<BR 

>, 

04, 

000400 , 


29 

000430 


OPCDEF 

<BVC 

>, 

04, 

102000 , 


30 

000440 


OPCDEF 

< BVS 

>, 

04, 

102400 , 


31 

000450 


OPCDEF 

<CCC 

>, 

00, 

000257, 


33 

000470 


OPCDEF 

<CLC 

>, 

00, 

000241 , 


34 

000500 


OPCDEF 

<CLN 

>, 

00 , 

000250 , 


35 

000510 


OPCDEF 

<CLR 

>, 

01, 

005000, 

DRl 

36 

000520 


OPCDEF 

<CLRB 

>, 

01, 

105000 , 

DRl 

39 

000550 


OPCDEF 

<CLV 

>, 

00 , 

000242 , 


40 

000560 


OPCDEF 

<CLZ 

>, 

00 , 

000244 , 
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1 

000570 

OPCDEF 

2 

000600 

OPCDEF 



CMZ 00 

3 

000630 

OPCDEF 

4 

000640 

OPCDEF 

5 

000650 

OPCDEF 

6 

000660 

OPCDEF 

7 

000670 

OPCDEF 

8 

000730 

OPCDEF 

9 

000740 

OPCDEF 

10 

000750 

OPCDEF 

11 

000760 

OPCDEF 

12 

000770 

OPCDEF 

13 

001000 

OPCDEF 

14 

001010 

OPCDEF 

15 

001230 

OPCDEF 

16 

001240 

OPCDEF 

17 

001320 

OPCDEF 

18 

001330 

OPCDEF 

19 

001360 

OPCDEF 

20 

001370 

OPCDEF 


<CMP 

>, 

02 , 

020000 , 


<CMPB 

000254 

>, 

r 

02, 

120000 , 


<COM 

>, 

01, 

005100 , 

DR1 

CCOMB 

>, 

01, 

105100 , 

DR1 

<DEC 

>, 

01, 

005300, 

DR1 

<DECB 

>, 

01, 

105300, 

DR1 

<EMT 

>, 

06, 

104000, 


CHALT 

>, 

00, 

000000, 


< INC 

>, 

01, 

005200, 

DR1 

< INCB 

>, 

01, 

105200, 

DR1 

< IOT 

>, 

00, 

000004 , 


< JMP 

>, 

01, 

000100 , 


< JSR 

>, 

05, 

004000, 

DR1 

<MOV 

>, 

02, 

010000 , 

DR 2 

<MOVB 

>, 

02, 

110000 , 

DR2 

<NEG 

>, 

01, 

005400 , 

DR1 

<NEGB 

>, 

01, 

105400 , 

DR1 

<NOP 

>, 

00 , 

000240, 


<RESET> , 

00, 

000005, 
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1 

001400 

OPCDEF 

2 

001410 

OPCDEF 

3 

001420 

OPCDEF 

4 

001430 

OPCDEF 

5 

001440 

OPCDEF 

6 

001450 

OPCDEF 

7 

001470 

OPCDEF 

8 

001500 

OPCDEF 

9 

001510 

OPCDEF 

10 

001520 

OPCDEF 

11 

001530 

OPCDEF 

12 

001600 

OPCDEF 

13 

001610 

OPCDEF 

14 

002020 

OPCDEF 

15 

002050 

OPCDEF 

16 

002070 

OPCDEF 

17 

002100 

OPCDEF 

18 

002110 

OPCDEF 

19 

002140 

OPCDEF 


XVM PAGE 4 


< ROL 

>, 

01, 

006100, 

DR1 

<ROLB 

>, 

01, 

106100 , 

DRl 

<ROR 

>, 

01, 

006000 , 

DR1 

<RORB 

>, 

01, 

106000 , 

DRl 

<RTI 

>, 

00 , 

000002, 


<RTS 

>, 

03, 

000200 , 

DRl 

<SBC 

>, 

01, 

005600 , 

DRl 

<SBCB 

>, 

01, 

105600, 

DRl 

<SCC 

>, 

00, 

000277 , 


<SEC 

> 

00, 

000261 , 


< SEN 

>, 

00, 

000270 , 


<SEV 

>, 

00, 

000262, 


<SEZ 

>, 

00, 

000264 , 


<S0B 

>, 

02, 

160000 , 


<SWAB 

>, 

01, 

000300 , 

DRl 

<TRAP 

>, 

06, 

104400 , 


<TST 

>, 

01, 

005700 , 


<TSTB 

>, 

01, 

105700 , 


< WAIT 

>, 

00, 

000001 , 
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1 

002160 

DIRDEF 

2 

002170 

DIRDEF 

3 

002210 

DIRDEF 

4 

002220 

DIRDEF 

5 

002230 

DIRDEF 

6 

002250 

DIRDEF 

7 

002260 

DIRDEF 

8 

002270 

DIRDEF 

9 

002300 

DIRDEF 

10 

002310 

DIRDEF 

11 

002320 

DIRDEF 

12 

002340 

DIRDEF 

13 

002350 

DIRDEF 

14 

002420 

DIRDEF 

15 

002430 

DIRDEF 

16 

002440 

DIRDEF 

17 

002450 

DIRDEF 

18 

002460 

DIRDEF 

19 

002470 

DIRDEF 

20 

002500 

DIRDEF 

21 

002510 

DIRDEF 

22 

002520 

DIRDEF 

23 

002530 

DIRDEF 

24 

002540 

DIRDEF 

25 

002550 

DIRDEF 

26 

002560 

DIRDEF 

27 

002570 

DIRDEF 

28 

002600 

DIRDEF 

29 

002610 

DIRDEF 

30 

002620 

DIRDEF 

31 

002630 

DIRDEF 

32 

002640 

DIRDEF 

33 

002660 

DIRDEF 


<ASCII> , 

DFLGBM 


<ASCIZ> , 

DFLGBM 


<BLKB 

>, 



<BLKW 

>, 

DFLGEV 


<BYTE 

>, 

DFLGBM 


<DSABL> , 



<ENABL> , 



<END 

>, 



<ENDC 

>, 

DFLCND 


<ENDM 

>, 

DFLMAC , 

XMACRO 

<ENDR 

>, 

DFLMAC , 

XMACRO 

<ERROR> , 



<EVEN 

>, 



< IF 

>, 

DFLCND 


< IFDF 

>, 

DFLCND 


< IFEQ 

>, 

DFLCND 


< IFF 

>, 

DFLCND 


<IFG 

>, 

DFLCND 


<IFGE 

>, 

DFLCND 


< IFGT 

>, 

DFLCND 


< IFL 

>, 

DFLCND 


< IFLE 

>, 

DFLCND 


< IFLT 

>, 

DFLCND 


< IFNDF> , 

DFLCND 


< IFNE 

>, 

DFLCND 


< IFNZ 

>, 

DFLCND 


< I FT 

>, 

DFLCND 


< IFTF 

>, 

DFLCND 


< IFZ 

>, 

DFLCND 


< I IF 

>, 



< IRP 

>, 

DFLMAC , 

XMACRO 

< IRPC 

>, 

DFLMAC , 

XMACRO 

< LIST 

>, 
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1 

002670 

DIRDEF 

2 

002700 

DIRDEF 

3 

002720 

DIRDEF 

4 

002730 

DIRDEF 

5 

002740 

DIRDEF 

6 

002750 

DIRDEF 

7 

002760 

DIRDEF 

8 

002770 

DIRDEF 

9 

003000 

DIRDEF 

10 

003010 

DIRDEF 

11 

003020 

DIRDEF 

12 

003030 

DIRDEF 

13 

003040 

DIRDEF 

14 

003050 

DIRDEF 

15 

003060 

DIRDEF 

16 

003070 

DIRDEF 

17 

003100 

WRDSYM: 

18 

003100 

DIRDEF 

19 



20 



21 

003110 

PSTTOP: 

22 



23 


000001 .END 


<MACR >, 

DFLMAC , 

XMACRO 

< MACRO , 

DFLMAC , 

XMACRO 

<MEXIT> , 

r 

XMACRO 

<NARG >, 

t 

XMACRO 

<NCHR >, 
<NLIST > 

r 

XMACRO 

<NTYPE> , 
<ODD >, 
<PAGE >, 
<PRINT>, 
<RADIX> , 

r 

XMACRO 

<RAD50> , 
<REM >, 

DFLGEV 


<REPT >, 
<SBTTL >, 
<TITLE >, 

DFLMAC , 

XMACRO 

<WORD >, 

DFLGEV 



, TOP LIMIT 


C-6 


* 



APPENDIX D 


ERROR MESSAGE SUMMARY 


D.l MACH ERROR CODES 


MACll error codes are printed following a field of six asterisk 
characters and on the line preceding the source line containing the 
error. For example: 

26 00236 000002' .WORD REL1+REL2 


The addition of two 


relocatable 


symbols is flagged as an A error. 


Error Code 


Meaning 


A 


B 


D 

E 

I 


L 


M 


N 


Addressing 
instruction 
relocation 
necessar ily 


error. An address within the 
is incorrect. Also may indicate a 

error. This message does not 

reflect a coding error. 


Bounding error. Instructions or word data are 
being assembled at an odd address in memory. The 
location counter is updated by +1. 

Doubly-defined symbol referenced. Reference was 
made to a symbol which is defined more than once. 

End directive not found. (A listing is 
generated . ) 


Illegal character detected. Illegal characters 
which are also non-printing are replaced by a ? 
on the listing. The character is then ignored. 

Line buffer overflow; i.e., input line greater 
than 132 characters. Extra characters on a line 
(more than 72(10)) are ignored. 


Multiple definition of a label. A label was 
encountered which was equivalent (in the first six 
characters) to a previously encountered label. 


Number containing 8 or 9 has decimal point 
missing . 
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ERROR MESSAGE SUMMARY 


Error Code Meaning 

0 Op-code error. Directive out of context. 

P Phase error. A label's definition of value varies 

from one pass to another. 

Q Questionable syntax. There are missing arguments 

or the instruction scan was not completed or a 
carriage return was not immediately followed by a 
line feed, form feed, or vertical tab. 

R Register-type error. An invalid use of or 

reference to a register has been made. 

T Truncation error. A number generated more than 16 

bits of significance or an expression generated 
more than 8 bits of significance during the use of 
the .BYTE directive. 

U Undefined symbol. An undefined symbol was 

encountered during the evaluation of an 

expression. Relative to the expression, the 

undefined symbol is assigned a value of zero. 

Z Instruction which is not compatible among all 

members of the PDP-11 family. 
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INDEX 


Absolute mode, 4-4 
Addition, 3-5 
Addition operator, 3-2 
Addressing, branch instruction, 

4- 6 

Address modes, 1-4, 4-1, 6-9 
syntax, B-2 

Address, negative, 1-6 
Ampersand (&) , 3-2 
AND operator, 3-2, 3-5 
Angle brackets (<>) , 2-3, 3-3, 

5- 13 

Apostrophe (') , 3-2, 6-8 
Arguments within a macro 
definition, 6-4 

ASCII character conversion, 5-10 
ASCII character indicator, 3-2 
ASCII characters, 2-3, A-l 
.ASCII directive, 5-11 
.ASCIZ directive, 5-12 
Assembler directives, 2-3, 3-5, 
B-10 

Assemblies, conditional, 1-4 
Assembly listing example 
(figure) , 5-4 

Assembly listing table of 
contents (figure) , 5-6 
Assembly location counter, 3-10, 
5-15, 5-16 
Asterisk (*) , 3-2 
At sign (@) , 3-2 

Autodecrement deferred mode, 4-3 
Autodecrement mode, 4-3 
Autoincrement deferred mode, 4-3 
Autoincrement mode, 4-2 


Backarrow («-) usage, 7-1 
Backslash (\) , 3-2, 6-6 
Binary operators, 3-5, 3-12 
Blank lines, 2-1 
. BLKB directive, 5-16 
. BLKW directive, 5-16 
Branch instruction addressing, 
4-6 

Branch instructions, B-8 
.BYTE directive, 5-8 


Carriage return, 2-1, 3-1 
Character deletion, 7-2 
Characters , 

ASCII, 2-3, A-l 
delimiting, 3-3 
illegal, 3-4 
MACH legal, 3-1 


Characters (cont.) , 

Radix-50, A-4 
separating, 3-3 
special, B-l 
Code, reentrant, 1-4 
Code segment (figure), 1-3 
Colon (:) usage, 2-2, 3-1 
Comma (,) , 2-3, 3-2, 3-3 
Command input string, 7-1 
Comments, 1-2, 2-3, 6-1 
field indicator, 3-2 
Concatenation, 6-8 
Conditional assembly, 1-4 
directives, 5-18 
PAL-11R directives, 5-22 
Conditional branch instructions, 
1-6 

Condition codes, B-3 
Continuation lines, 2-1 
Core Storage, 1-5, 3-8 


Data generation, 5-9 
Data storage directives, 5-8 
Deferred addressing indicator, 
3-2 

Deletion of characters or lines, 
7-2 

Delimiting characters, 3-3 
Direct assignment indicator, 3-1 
Direct assignments, 3-6 
Directives, assembler, 2-3, 3-5, 
B-10 

conditional, 5-18 
immediate conditional, 5-21 
MACRO, 6-1 

PAL-11R conditional assembly, 
5-2 2 

subconditional, 5-20 
terminating, 5-17 
Dispatch table, 1-5 
Division, 3-5 
operator, 3-2 

Double-operand instructions, B-4 
Double quote (") , 3-2 
. DSABL directive, 5-7 


.ENABL directive, 5-7 
.END directive, 5-17 
•ENDM directive, 6-2 
.ENDR statement, 6-14 
•ERROR directive, 6-10 
Error message summary, D-l 
Errors, typing, 7-2 
Equal sign (=) , 3-1 
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•EVEN directive, 5-15 
Exclamation (!), 3-2 
Expression indicator, 3-2 
Expressions, 3-12 


Fields in statements, 2-1 
comment, 2-3 
label, 2-2 
operand, 2-3 
operator, 2-3 
Field terminator, 3-1 
Format control, 2-4 
Form feed, 2-1, 3-1, 6-3 
Forward referencing, 3-7 


Hierarchy operator, 3-12 


Illegal characters, 3-4 
.IFF directive, 5-20 
. IFT directive, 5-20 
. IFTF directive, 5-20 
Immediate conditional directive, 
5-21 

Immediate expression indicator, 
3-1 

Immediate mode, 4-4 
Indefinite repeat block: .IRP 

and . IRPC , 6-11 
Index deferred mode, 4-4 
Index mode, 4-3 
Indicators , 3-2 

Initial register indicator, 3-2 
Instructions, 2-3, 3-5, B-3 
conditional branch, 1-6 
(figure) , 1-3 
Item terminator, 3-1 


Label field, 2-2 
Label terminator, 3-1 
Line deletion, 7-2 
Line feed, 3-1 
Line formatting, 2-4 
Line printer listing (figure) , 
5-4 

Line terminators, 2-1 
.LIST directive, 5-1 
Listing level count, 5-1 
Loading MACH, 7-1 
Local symbol blocks (Figure) , 
3-9 

Local symbols, 3-8 


Location counter control, 5-15 
Logical operations, B-4 


•MACRO directive, 6-1 
Macros , 

calls, 6-3 

definition formatting, 6-3 
directives, 6-1 
nesting, 6-4 

numeric argument indicator, 3 
symbols, 3-5 
Mask word, 5-14 
Message output, 6-10 
.MEXIT directive, 6-2 
.MEXIT statement, 6-14 
Minus sign (-) , 3-2 
Mode forms and codes, 4-5 
Modes of address, 4-1 
Modular programming, 1-1 
Multiplication, 3-5 
Multiplication operator, 3-2 


.NARG directive, 6-9 
. NCHR directive, 6-9 
Negative address, 1-6 
Negative numbers, 3-11 
Nested angle brackets, 3-3 
Nested macros, 6-2, 6-4 
.NLIST directives, 5-1 
.NTYPE directive, 6-9 
Null arguments, 6-7 
Number of arguments in a macro 
call, 6-7, 6-9 

Number of characters in string, 
6-9 

Numbers, 3-11, 5-14 
Number sign (#), 3-1 
Numeric arguments, 6-6 


Octal radix, 3-11 
.ODD directive, 5-16 
Offset, 3-10, 4-6 
I's Complement, 3-4 
Op-codes, B-3 
Operand field, 2-3, 3-2 
Operands, B-3 
Operate instructions, B-6 
Operating procedures, 7-1 
Operator field, 2-3 
Operator hierarchy, 3-12 
Operators, 3-2 
OR operator, 3-2, 3-5 
Output, 7-1 
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.PAGE directive, 5-7, 6-3 
Page eject, 5-7, 6-3 
Page headings, 5-3 
PAL-11R conditional assembly 
directives, 5-22 
Paper tape sources, 7-2 
Parameter assignments, 1-5 
Parentheses () , 3-2 
Pass 1, 7-2 
PC register, 1-4 
PDP-11 code segment (figure) , 
1-3 

Percent sign (%) , 3-1, 3-8 
Period ( . ) , 3-10 
Permanent symbols, 3-5 
Permanent symbol table, C-l 
Plus sign ( + ) , 3-2 
Processor status word (PS) , B-3 
Program counter (PC) , 4-1 
Program stack, 1-2 


•RAD50 directive, 5-12 
Radix controls, temporary, 5-14 
•RADIX directive, 3-11, 5-14 
Radix-50, 5-13 

character set, A-l 
Reentrant code, 1-4 
Register addressing, 1-4 
Register deferred mode, 4-2 
Register destination, B-9 
Register increment, 1-6 
Register mode, 4-2 
Register names, 1-5 
Register symbols, 3-7 
Register term indicator, 3-1 
Register usage, 1-2 
Relative deferred mode, 4-5 
Relative mode, 4-5 
Repeat block: .REPT, 6-13 

Rubout key, 7-2 


Subconditional directives, 5-20 
Subroutine return, B-9 
Subroutines, 1-2 
Subtraction, 3-5 
Subtraction operator, 3-2 
Symbolic addressing, 1-2 
Symbols , 

automatically created, 6-7 
local, 3-8 
user-defined, 3-5 


Table of contents for assembly 
listing, 5-6 
Tabs, 2-3 

Temporary radix controls, 5-14 
Terminal register indicator, 3-2 
Terminating directives, 5-17 
Terminators, 3-1 

Terms in expressions, 3-11, 3-12 
.TITLE directive, 5-3 
Trap handler, 1-5 
Trap instructions, B-7 
Truncation, 3-11, 4-7, 5-8, 5-9 
2 1 s complement, 3-4, 3-11 


Unary operators, 3-4, 3-12, 5-15 
Underbar (_) usage, 7-1 
Up arrow (+) , 3-2, 3-3 
User-defined symbols, 3-5 
User Symbol Table, 3-5, 3-8 


Vertical formatting, 2-4 
Vertical tab, 2-1, 3-1 


.WORD directive, 2-3, 5-9 


. SBTTL directive, 5-5 
Semicolon (;) usage, 2-3, 3-2 
Single-operand instructions, B-4 
Single quote ('), 3-2, 6-8 
Slash (/) , 3-2 
Source file, 7-2 
Source program format, 2-1 
Spaces, 2-3, 3-1, 3-3 
Special characters, B-l 
Special characters within 
arguments, 6-5 
Statement format, 2-1 
Statement terminator, 2-1, 3-1 
Storage area, reserved, 3-11 
Storage space, 1-5 
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